<div class="content"><p>The <b>RRouterInterfaceGetCredentialsLocal</b> method<a id="Appendix_A_Target_327"></a><a aria-label="Product behavior note 327" href="3bb906f0-b077-47ab-ad11-d8d807afde26#Appendix_A_327" data-linktype="relative-path">&lt;327&gt;</a> is used to get credentials
information for an interface. Specifically, the username, domain name, and
password used in user authentication are retrieved with this method. </p><dl>
<dd>
<div><pre> DWORD RRouterInterfaceGetCredentialsLocal(
   [in] DIM_HANDLE hDimServer,
   [in, string] LPWSTR lpwsInterfaceName,
   [out] [string] LPWSTR *lpwsUserName,
   [out] [string] LPWSTR *lpwsDomainName,
   [out] [string] LPWSTR *lpwsPassword
 );
</pre></div>
</dd></dl><p><b>hDimServer: </b>A handle to the RRASM server where
the call is to be executed, see section <a href="1f8cdbcc-9791-4a35-ad78-878b8d110e15" data-linktype="relative-path">3.1.3</a>.</p><p><b>lpwsInterfaceName: </b>A pointer to a
null-terminated Unicode string that contains the name of the interface for
which credentials need to be set. The length of the string MUST NOT be more
than 256 characters, otherwise an error is returned. The client SHOULD free
this memory.</p><p><b>lpwsUserName: </b>A pointer to a null-terminated
Unicode string that contains the name of the user on this connection. The
string length MUST NOT be more than 256 characters. The client SHOULD free the
memory pointed to by <i>lpwsUserName</i>.</p><p><b>lpwsDomainName: </b>A pointer to a null-terminated
Unicode string that contains the domain name. The string length MUST NOT be
more than 16 characters. The client SHOULD free the memory pointed to by <i>lpwsDomainName</i>.</p><p><b>lpwsPassword: </b>A pointer to a null-terminated
Unicode string that contains the password of the user on this connection. The
string length MUST NOT be more than 256 characters. The client SHOULD free the
memory pointed to by <i>lpwsPassword</i>.</p><p><b>Return Values: </b>A 32-bit unsigned integer value
that indicates return status. A return value of ERROR_SUCCESS (0x00000000)
indicates the operation was completed successfully; otherwise it contains an
error code, as specified in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>
or in section <a href="5c0c991a-0d3d-4fe5-9503-5128d0d49fe1" data-linktype="relative-path">2.2.4</a>.
All values that are not in the table that follows MUST be treated the same by
the RRASM client. </p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>ERROR_SUCCESS</p>
  <p>0x00000000</p>
  </td>
  <td>
  <p>The call was successful.</p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_ACCESS_DENIED</p>
  <p>0x00000005</p>
  </td>
  <td>
  <p>The calling application does not have sufficient
  privileges.</p>
  </td>
 </tr></tbody></table>
</dd></dl><p>The opnum field value for this method is 50.</p><p>When processing this call, the RRASM server MUST do the
following:</p><ul><li><p><span><span> 
</span></span>Validate, as specified in section <a href="9373431f-ed29-4639-9f8b-743267c9f9b6" data-linktype="relative-path">2.1.1.1</a>, whether this
method was called by a client that has access to the method. If the client does
not have access, then return error ERROR_ACCESS_DENIED (0x00000005).</p>
</li><li><p><span><span> 
</span></span>If an interface with the name <i>lpwsInterfaceName</i> does not
exists on the server, return an error other than one of the errors listed in
the preceding table.</p>
</li><li><p><span><span> 
</span></span>Call the abstract interface <b>Invoke DIMSVC</b> method
specifying the operation and the parameters to enable RRAS server to perform
the required management task.</p>
</li><li><p><span><span> 
</span></span>Return any error status the RRAS server returns. Otherwise return
ERROR_SUCCESS (0x00000000).</p>
</li></ul><p>No exceptions are thrown beyond those thrown by the
underlying RPC protocol <a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a>.</p></div>