EapHostPeerGetMethodProperties 関数 (eaphostpeerconfigapis.h)
EapHostPeerGetMethodProperties 関数は、接続とユーザー データを指定して EAP メソッドのプロパティを取得するために使用されます。
構文
DWORD EapHostPeerGetMethodProperties(
[in] DWORD dwVersion,
[in] DWORD dwFlags,
[in] EAP_METHOD_TYPE eapMethodType,
[in] HANDLE hUserImpersonationToken,
[in] DWORD dwEapConnDataSize,
[in] const BYTE *pbEapConnData,
[in] DWORD dwUserDataSize,
[in] const BYTE *pbUserData,
[out] EAP_METHOD_PROPERTY_ARRAY *pMethodPropertyArray,
[out] EAP_ERROR **ppEapError
);
パラメーター
[in] dwVersion
API のバージョン番号。 このパラメーターを 0 に設定します。
[in] dwFlags
EAP 認証セッションの動作を記述する EAP フラグ の組み合わせ。
[in] eapMethodType
サプリカントが使用する EAP メソッドを指定する EAP_METHOD_TYPE 構造体。
[in] hUserImpersonationToken
このセッションで使用するユーザー偽装トークンへのハンドル。
[in] dwEapConnDataSize
pbEapConnData で提供される接続データ バッファーのサイズ (バイト単位)。
[in] pbEapConnData
EAP メソッドに使用される接続データ。 NULL に設定すると、レジストリで構成されているメソッドの静的プロパティが返されます。
[in] dwUserDataSize
pbUserData で提供されるユーザー データ バッファーのサイズ (バイト単位)。
[in] pbUserData
不透明なユーザー データ BLOB を含むバイト バッファーへのポインター。 このパラメーターは、NULL でもかまいません。
[out] pMethodPropertyArray
メソッドプロパティ配列へのポインター EAP_METHOD_PROPERTY_ARRAY。 呼び出し元は、最も内側のポインターから始まる EapHostPeerFreeMemory を使用して内部ポインターを解放する必要があります。 呼び出し元は、型が empvtString の場合にのみ 、empvString 値を解放する必要があります。
[out] ppEapError
この関数呼び出しの実行中に EAPHost によって発生したエラーを含む EAP_ERROR 構造体へのポインターへのポインター。 エラー データを使用した後、 EapHostPeerFreeErrorMemory へのポインターを渡すことによって、このメモリを解放する必要があります。
戻り値
なし
解説
EapHostPeerGetMethodProperties を使用すると、ユーザーは EAPHost サプリカント インターフェイスを使用して EAP メソッドのプロパティを取得できます。 この API によって返されるプロパティは、 EapHostPeerGetMethods 関数によって返されるプロパティとは異なる場合があります。 EapHostPeerGetMethodProperties 関数は、特定の接続とユーザー データの EAP メソッドのプロパティを返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | eaphostpeerconfigapis.h |
| Library | Eappcfg.lib |
| [DLL] | Eappcfg.dll |