EapHostPeerSetResponseAttributes 関数 (eappapis.h)

更新された EAP 認証属性を EAPHost に提供します。

構文

DWORD EapHostPeerSetResponseAttributes(
  [in]  EAP_SESSIONID               sessionHandle,
  [in]  const EapAttributes * const pAttribs,
  [out] EapHostPeerResponseAction   *pEapOutput,
  [out] EAP_ERROR                   **ppEapError
);

パラメーター

[in] sessionHandle

EAPHost サーバー 上のこの EAP 認証セッションの一意のハンドルを含むEAP_SESSIONID構造体へのポインター。 このハンドルは、EapHostPeerBeginSession の以前の呼び出しで pSessionId パラメーターで返されます。

[in] pAttribs

EAPHost 上のサプリカントに設定する新しい EAP 認証応答属性の配列を含む EapAttributes 構造体へのポインター。

[out] pEapOutput

サプリカントが応答として実行する必要がある次のステップのアクション コードを指定する EapHostPeerResponseAction 列挙値へのポインター。

[out] ppEapError

EAP_ERROR構造体のアドレスへのポインター。 この関数を呼び出す前に、アドレスを NULL に設定する必要があります。 エラー データが使用可能な場合は、この関数呼び出しの実行中に発生したエラーを含む EAP_ERROR 構造体のアドレスへのポインターが受信されます。 エラー データを使用した後、 EapHostPeerFreeEapError を呼び出してこのメモリを解放します。

戻り値

なし

解説

EapHostPeerGetResponseAttributes の呼び出し後にステート マシンの次のステップに進むには、サプリカントは EapHostPeerSetResponseAttributes を呼び出す必要があります。 サプリカントが EapHostPeerGetResponseAttributes から返された属性を使用できない場合でも、サプリカントは有効な EapAttributes 構造体を渡すためにこれを行う必要があります。

次の例は、ステート マシンの次の状態に進むためだけに行われる EapHostPeerSetResponseAttributes 呼び出しを示しています。

EapHostPeerGetResponseAttributes(session_id, &eapAttributes, ppEapError);

// overwrite attributes returned by EapHostPeerGetResponseAttributes
EapAttributes eapAttributes={0,NULL};

// progress to the next state in the state machine
EapHostPeerSetResponseAttributes(session_id, &eapAttributes, pEapOutput, ppEapError);

要件

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

関連項目

EAPHost サプリカントランタイム関数

EapHostPeerGetResponseAttributes