MprAdminInterfaceGetCredentials 函式 (mprapi.h)
使用 MprAdminInterfaceGetCredentials 函式來擷取網域、使用者名稱和密碼，以在指定的需求撥號介面上撥出。
語法
DWORD MprAdminInterfaceGetCredentials(
[in] LPWSTR lpwsServer,
[in] LPWSTR lpwsInterfaceName,
[out] LPWSTR lpwsUserName,
[out] LPWSTR lpwsPassword,
[out] LPWSTR lpwsDomainName
);
參數
[in] lpwsServer
Null終止 Unicode 字串的指標，指定要在其中執行此呼叫的路由器名稱。
這是選擇性參數。 如果呼叫應用程式指定此參數的 Null ，則會在本機電腦上執行呼叫。
[in] lpwsInterfaceName
指定需求撥號介面名稱之 Null終止 Unicode 字串的指標。 使用 MprAdminInterfaceGetInfo 取得介面名稱。
[out] lpwsUserName
接收使用者名稱的 Unicode 字串指標。 此字串應該是 UNLEN+1 長。
這是選擇性參數。 如果呼叫的應用程式指定此參數的 Null ，則函式不會傳回使用者名稱。
[out] lpwsPassword
接收密碼的 Unicode 字串指標。 此字串應該是 PWLEN+1 long。
這是選擇性參數。 如果呼叫的應用程式指定此參數的 Null ，則函式不會傳回密碼。
[out] lpwsDomainName
接收功能變數名稱的 Unicode 字串指標。 此字串應該是 DNLEN+1 long。
這是選擇性參數。 如果呼叫的應用程式指定此參數的 Null ，則函式不會傳回功能變數名稱。
傳回值
如果函式成功，傳回值會NO_ERROR。
如果函式失敗，傳回值就是下列其中一個錯誤碼。
| 值 | 意義 |
|---|---|
|
指定的介面沒有任何與其相關聯的需求撥號參數。 |
|
lpwsInterfaceName參數為Null。 |
|
lpwsUserName、lpwsPassword和lpwsDomainName參數全都是Null。 |
|
使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。 |
備註
lpwsUserName、lpwsPassword和lpwsDomainName參數是選擇性的。 如果呼叫的應用程式針對這三個參數指定 Null ， 則不會傳回 MprAdminInterfaceGetCredentials NO_ERROR，而且不會傳回網域、使用者名稱和密碼。
UNLEN、PWLEN 和 DNLEN 常數是使用者名稱、密碼和功能變數名稱的最大長度。 這些常數定義于 lmcons.h 中。
請注意， MprAdminInterfaceGetCredentials 中的參數順序與 MprAdminInterfaceSetCredentials不同。
需求
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | mprapi.h |
| 程式庫 | Mprapi.lib |
| Dll | Mprapi.dll |