MprAdminServerGetCredentials 函式 (mprapi.h)

MprAdminServerGetCredentials 函式會擷取指定伺服器的預先共用密鑰。

語法

DWORD MprAdminServerGetCredentials(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

參數

[in] hMprServer

Windows 伺服器的句柄。 藉由呼叫 MprAdminMIBServerConnect 來取得此句柄。

[in] dwLevel

DWORD 值，描述 lplpbBuffer 參數中傳回資訊的格式。 必須為零。

[out] lplpbBuffer

成功完成時， MPR_CREDENTIALSEX_1結構的指標 ，其中包含伺服器的預先共用密鑰。 使用 MprAdminBufferFree 釋放這個結構所佔用的記憶體。

傳回值

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

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

值	意義
ERROR_ACCESS_DENIED	呼叫的應用程式沒有足夠的許可權。
ERROR_INVALID_PARAMETER	lplpbBuffer 參數為 NULL。
ERROR_NOT_SUPPORTED	dwLevel 參數不是零。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。

備註

伺服器會維護所有使用者的單一預先共用金鑰。

規格需求

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

另請參閱

MPR_CREDENTIALSEX_1

MprAdminServerSetCredentials

路由器管理功能

路由器管理參考