MprAdminInterfaceSetCredentials 函式 (mprapi.h)
使用 MprAdminInterfaceSetCredentials 函 式來設定將用於在指定需求撥號介面上撥出的網域、使用者名稱和密碼。
語法
DWORD MprAdminInterfaceSetCredentials(
[in] LPWSTR lpwsServer,
[in] LPWSTR lpwsInterfaceName,
[in] LPWSTR lpwsUserName,
[in] LPWSTR lpwsDomainName,
[in] LPWSTR lpwsPassword
);
參數
[in] lpwsServer
以 Null終止的 Unicode 字串指標，指定要在其中執行此呼叫之路由器的名稱。
這是選擇性參數。 如果呼叫應用程式指定此參數的 Null ，則會在本機電腦上執行呼叫。
[in] lpwsInterfaceName
指定需求撥號介面名稱之 Null終止 Unicode 字串的指標。 使用 MprAdminInterfaceGetInfo 來取得介面名稱。
[in] lpwsUserName
指定使用者名稱之 Null終止 Unicode 字串的指標。
這是選擇性參數。 如果呼叫應用程式為此參數指定 Null ，則函式不會變更與此介面相關聯的使用者名稱。
[in] lpwsDomainName
指定功能變數名稱之 Null終止 Unicode 字串的指標。
這是選擇性參數。 如果呼叫應用程式指定此參數的 Null ，此函式不會變更與此介面相關聯的功能變數名稱。
[in] lpwsPassword
指定密碼之 Null終止 Unicode 字串的指標。
這是選擇性參數。 如果呼叫的應用程式指定此參數的 Null ，此函式不會變更與此介面相關聯的密碼。
傳回值
如果函式成功，傳回值會NO_ERROR。
如果函式失敗，傳回值就是下列其中一個錯誤碼。
| 值 | 意義 |
|---|---|
|
至少符合下列其中一項條件：
|
|
記憶體不足，無法建立新的資料結構以包含認證。 |
|
使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。 |
備註
lpwsUserName、lpwsPassword和lpwsDomainName參數是選擇性的。 如果呼叫應用程式針對這三個參數指定 Null ， MprAdminInterfaceSetCredentials 會移除此介面的所有認證資訊。
UNLEN、PWLEN 和 DNLEN 常數是使用者名稱、密碼和功能變數名稱的最大長度。 這些常數定義于 Lmcons.h 中。
請注意， MprAdminInterfaceSetCredentials 中的參數順序與 MprAdminInterfaceGetCredentials不同。
需求
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mprapi.h |
| 程式庫 | Mprapi.lib |
| Dll | Mprapi.dll |