共用方式為

MprAdminInterfaceGetCredentialsEx 函式 (mprapi.h)

  • 發行項

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

語法

DWORD MprAdminInterfaceGetCredentialsEx(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

參數

[in] hMprServer

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

[in] hInterface

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

[in] dwLevel

DWORD 值，描述 lplpbBuffer 參數中傳回資訊的格式。 dwLevel 可接受的值為 0 或 1，如下表所列。

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

值為 1 表示資訊是介面的預先共用金鑰，其格式為加密格式。

[out] lplpbBuffer

成功完成時， 指向MPR_CREDENTIALSEX_0 或 MPR_CREDENTIALSEX_1 結構的指標。 dwLevel 參數會指出結構的型別。 使用 MprAdminBufferFree 釋放這個結構所佔用的記憶體。

傳回值

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

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

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

規格需求

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

另請參閱

MPR_CREDENTIALSEX_0

MPR_CREDENTIALSEX_1

MprAdminInterfaceCreate

MprAdminInterfaceGetCredentials

MprAdminInterfaceSetCredentialsEx

MprAdminServerConnect