MprAdminServerSetCredentials 函式 (mprapi.h)

MprAdminServerSetCredentials 函式會設定指定伺服器的預先共用密鑰。

語法

DWORD MprAdminServerSetCredentials(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

[in] hMprServer

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

[in] dwLevel

DWORD 值，描述資訊在 lpbBuffer 參數中結構化的格式。必須為零。

[in] lpbBuffer

包含伺服器預先共用索引鍵之MPR_CREDENTIALSEX_1 結構的指標。

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

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

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

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

若要刪除預先共用的密鑰，請呼叫 MprAdminServerSetCredentials ，並將 MPR_CREDENTIALSEX_1dwSize 成員設定為零。