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

こちらもご覧ください

EAPHost Authenticator メソッド関数

EapHostPeerBeginSession