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 |