EapMethodAuthenticatorBeginSession 関数 (eapmethodauthenticatorapis.h)
サーバー EAPHost に新しい EAP 認証セッションを作成します。
EapMethodAuthenticatorBeginSession は関数プロトタイプです。
構文
DWORD EapMethodAuthenticatorBeginSession(
[in] DWORD dwFlags,
[in] BYTE bInitialId,
LPCWSTR pwszIdentity,
[in] const EapAttributes * const pAttributeArray,
[in] DWORD dwSizeofConnectionData,
const BYTE * const pConnectionData,
[in] DWORD dwMaxSendPacketSize,
[out] EAP_SESSION_HANDLE *pSessionHandle,
[out] EAP_ERROR **ppEapError
);
パラメーター
[in] dwFlags
EAP 認証セッションの動作を記述する EAP フラグ の組み合わせ。
[in] bInitialId
認証するユーザーの ID を含む、0 で終わる Unicode 文字列。
pwszIdentity
認証されるユーザーの ID。
[in] pAttributeArray
認証するエンティティの EAP 属性を指定する EapAttributes 配列構造体へのポインター。
[in] dwSizeofConnectionData
pConnectionData が指すデータのサイズをバイト単位で指定します。 pConnectionData が NULL の場合、このメンバーは 0 です。
pConnectionData
認証プロトコルの構成ユーザー インターフェイスから受信した接続データへのポインター。
[in] dwMaxSendPacketSize
セッション中に送信される EAP パケットの最大サイズをバイト単位で指定します。
[out] pSessionHandle
EAPHost サーバー上のこの EAP 認証セッションの一意のハンドルを含む EAP_SESSION_HANDLE 構造体へのポインター。
[out] ppEapError
必要に応じて、この関数呼び出しの実行中に EAPHost によって発生したエラーを含む EAP_ERROR 構造体へのポインターへのポインターを受け取ります。 エラー データを使用した後、エラー データへのポインターを EapMethodAuthenticatorFreeMemory に渡すことで、このメモリを解放する必要があります。
戻り値
なし
解説
この呼び出しは、この API への関数ポインターを使用して、認証システム ベースの EAPHost によって実行されます。 この API は、EAPHost によって読み込まれた EAP 認証メソッドに実装する必要があり、ドキュメントで指定されている構文とパラメーターの型に厳密に準拠している必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | eapmethodauthenticatorapis.h |