MprAdminServerGetCredentials 関数 (mprapi.h)

  • [アーティクル]

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

構文

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

パラメーター

[in] hMprServer

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

[in] dwLevel

lplpbBuffer パラメーターで情報が返される形式を表す DWORD 値。 ゼロを指定してください。

[out] lplpbBuffer

正常に完了すると、サーバーの事前共有キーを含む MPR_CREDENTIALSEX_1 構造体へのポインター。 MprAdminBufferFree を使用して、この構造体によって占有されているメモリを解放します。

戻り値

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

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

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

注釈

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

要件

要件 値
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー mprapi.h
Library Mprapi.lib
[DLL] Mprapi.dll

こちらもご覧ください

MPR_CREDENTIALSEX_1

MprAdminServerSetCredentials

ルーター管理機能

ルーター管理リファレンス