EapPeerBeginSession 関数 (eapmethodpeerapis.h)

EAP メソッドを使用して、ピア EAPHost で EAP 認証セッションを開始します。

構文

DWORD EapPeerBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  HANDLE                      hTokenImpersonateUser,
  [in]  DWORD                       dwSizeofConnectionData,
  [in]  BYTE                        *pConnectionData,
  [in]  DWORD                       dwSizeofUserData,
  [in]  BYTE                        *pUserData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

パラメーター

[in] dwFlags

新しい EAP 認証セッションの動作を記述する EAP フラグ の組み合わせ。

[in] pAttributeArray

認証するエンティティの EAP 属性を指定する EAP_ATTRIBUTES 配列構造体へのポインター。

[in] hTokenImpersonateUser

このセッションで使用するユーザー偽装トークンへのハンドルを指定します。

[in] dwSizeofConnectionData

pConnectionData で提供される接続データ バッファーのサイズをバイト単位で指定します。

[in] pConnectionData

このメソッドに固有の接続データは、この API から返されるユーザー データを決定するために使用されます。この場合、ユーザー データは特定の接続データ構成に依存します。 このパラメーターが NULL の 場合、メソッドの実装では接続に既定値を使用する必要があります。

[in] dwSizeofUserData

pUserData で提供されるユーザー データ バッファーのサイズをバイト単位で指定します。

[in] pUserData

不透明なユーザー データ BLOB を含むバイト バッファーへのポインター。

[in] dwMaxSendPacketSize

セッション中に送信される EAP パケットの最大サイズをバイト単位で指定します。 メソッドが最大サイズを超えるパケットを送信する必要がある場合、メソッドは断片化に対応し、再組み立てする必要があります。

[out] pSessionHandle

EAPHost サーバー上のこの EAP 認証セッションの一意のハンドルを含む EAP_SESSION_HANDLE 構造体へのポインター。

[out] ppEapError

この関数呼び出しの実行中に発生したエラーを含む EAP_ERROR 構造体へのポインター。 エラー データを使用した後、 EapPeerFreeErrorMemory を呼び出してこのメモリを解放する必要があります。

戻り値

なし

解説

この呼び出しは、この API への関数ポインターを使用して、ピア ベースの EAPHost によって実行されます。 この API は、EAPHost によって読み込まれる EAP メソッドに実装する必要があり、ドキュメントで指定されている構文とパラメーターの型に厳密に準拠している必要があります。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	eapmethodpeerapis.h

関連項目

EAPHost ピア メソッド Run-Time 関数

EapPeerEndSession

SSO と PLAP