MprAdminInterfaceSetCredentialsEx 関数 (mprapi.h)

[アーティクル]
02/29/2024

MprAdminInterfaceSetCredentialsEx 関数を使用して、インターフェイスの拡張資格情報を設定します。この関数を使用して、拡張認証プロトコル (EAP) に使用される資格情報を設定します。

構文

DWORD MprAdminInterfaceSetCredentialsEx(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

パラメーター

[in] hMprServer

ルーターへのハンドル。このハンドルは、 MprAdminServerConnect の以前の呼び出しから取得されます。

[in] hInterface

インターフェイスへのハンドル。このハンドルは、 MprAdminInterfaceCreate の以前の呼び出しから取得されます。

[in] dwLevel

lpbBuffer パラメーターで情報を構造化する形式を表す DWORD 値。 dwLevel に使用できる値は、次の表に示すように 0 または 1 です。値 1 は、情報がインターフェイスの事前共有キーであることを示します。

値	構造体の形式
0	Windows 2000 Server: MPR_CREDENTIALSEX_0
1	Windows Server 2003 以降: MPR_CREDENTIALSEX_1

[in] lpbBuffer

MPR_CREDENTIALSEX_0またはMPR_CREDENTIALSEX_1構造体へのポインター。 dwLevel パラメーターは、構造体の種類を示します。

戻り値

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

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

値	意味
ERROR_ACCESS_DENIED	呼び出し元のアプリケーションに十分な特権がありません。
ERROR_INVALID_HANDLE	hInterface 値が無効です。
ERROR_INVALID_PARAMETER	lplpbBuffer パラメーターは NULL です。
ERROR_NOT_ENOUGH_MEMORY	操作を完了するためのリソースが不足しています。
ERROR_NOT_SUPPORTED	dwLevel 値が無効です。

注釈

事前共有キーを削除するには、MPR_CREDENTIALSEX_1構造体の dwSize メンバーを 0 に設定して MprAdminInterfaceSetCredentials を呼び出します。

要件

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