MprAdminServerSetCredentials 関数 (mprapi.h)

MprAdminServerSetCredentials 関数は、指定されたサーバーの事前共有キーを設定します。

構文

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

[in] hMprServer

Windows サーバーへのハンドル。 MprAdminMIBServerConnect を呼び出して、このハンドルを取得します。

[in] dwLevel

lpbBuffer パラメーターで情報を構造化する形式を表す DWORD 値。ゼロを指定してください。

[in] lpbBuffer

サーバーの事前共有キーを含む MPR_CREDENTIALSEX_1 構造体へのポインター。

関数が成功した場合、戻り値はNO_ERROR。

関数が失敗した場合、戻り値は次のいずれかのエラーコードになります。

値	意味
ERROR_ACCESS_DENIED	呼び出し元のアプリケーションに十分な特権がありません。
ERROR_INVALID_PARAMETER	lpbBuffer パラメーターは NULL です。
ERROR_NOT_SUPPORTED	dwLevel パラメーターが 0 ではありません。
その他	FormatMessage を使用して、返されたエラーコードに対応するシステムエラーメッセージを取得します。

サーバーは、すべてのユーザーに対して 1 つの事前共有キーを保持します。

事前共有キーを削除するには、MPR_CREDENTIALSEX_1dwSize メンバーを 0 に設定して MprAdminServerSetCredentials を呼び出します。