EapHostPeerGetUIContext 関数 (eappapis.h)

UI が発生する場合は、EAPHost からサプリカントのユーザー インターフェイス コンテキストを取得します。

EAPHostPeerGetUIContext の後には、常に次の関数が続きます。

• EapHostPeerInvokeInteractiveUI、および
• EapHostPeerSetUIContext

構文

DWORD EapHostPeerGetUIContext(
  [in]  EAP_SESSIONID sessionHandle,
  [out] DWORD         *pdwSizeOfUIContextData,
  [out] BYTE          **ppUIContextData,
  [out] EAP_ERROR     **ppEapError
);

パラメーター

[in] sessionHandle

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

[out] pdwSizeOfUIContextData

ppUIContextData で返される UI コンテキスト データ バッファーのサイズをバイト単位で指定する値へのポインター。

[out] ppUIContextData

EAPHost からのサプリカント UI コンテキスト データを含むバッファーへのポインターへのポインター。 このパラメーターが指すアドレスは、IN パラメーター pUIContextData として EapHostPeerInvokeInteractiveUI に渡されます。

[out] ppEapError

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

戻り値

なし

必要条件

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

こちらもご覧ください

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

EapHostPeerInvokeInteractiveUI

EapHostPeerSetUIContext