MprAdminInterfaceSetCredentialsEx 函式 (mprapi.h)

發行項
03/05/2024

使用 MprAdminInterfaceSetCredentialsEx 函式來設定介面的擴充認證資訊。使用此函式可設定用於可延伸驗證通訊協定的認證資訊， (EAP) 。

語法

DWORD MprAdminInterfaceSetCredentialsEx(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

參數

[in] hMprServer

路由器的句柄。此句柄是從先前呼叫 MprAdminServerConnect 取得。

[in] hInterface

介面的句柄。此句柄是從先前呼叫 MprAdminInterfaceCreate 取得。

[in] dwLevel

DWORD 值，描述資訊在 lpbBuffer 參數中結構化的格式。 dwLevel 可接受的值包括 0 或 1，如下表所列。值為 1 表示資訊是介面的預先共用金鑰。

值	結構格式
0	Windows 2000 Server： MPR_CREDENTIALSEX_0
1	Windows Server 2003 或更新版本： MPR_CREDENTIALSEX_1

[in] lpbBuffer

MPR_CREDENTIALSEX_0或MPR_CREDENTIALSEX_1 結構的指標。 dwLevel 參數表示結構的類型。

傳回值

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

值	意義
ERROR_ACCESS_DENIED	呼叫的應用程式沒有足夠的許可權。
ERROR_INVALID_HANDLE	hInterface 值無效。
ERROR_INVALID_PARAMETER	lplpbBuffer 參數為 NULL。
ERROR_NOT_ENOUGH_MEMORY	資源不足，無法完成作業。
ERROR_NOT_SUPPORTED	dwLevel 值無效。

備註

若要刪除預先共用的密鑰，請呼叫 MprAdminInterfaceSetCredentials，並將 MPR_CREDENTIALSEX_1 結構的 dwSize 成員設定為零。

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	mprapi.h
程式庫	Mprapi.lib
Dll	Mprapi.dll