次の方法で共有

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

こちらもご覧ください

EAPHost サプリカント構成関数