次の方法で共有

EapPeerGetIdentity 関数 (eapmethodpeerapis.h)

  • [アーティクル]

EAPHost によって呼び出された後、ユーザー データとユーザー ID を返します。

構文

DWORD EapPeerGetIdentity(
  [in]      DWORD      dwFlags,
  [in]      DWORD      dwSizeofConnectionData,
  [in]      const BYTE *pConnectionData,
  [in]      DWORD      dwSizeofUserData,
  [in]      const BYTE *pUserData,
  [in]      HANDLE     hTokenImpersonateUser,
  [out]     BOOL       *pfInvokeUI,
  [in, out] DWORD      *pdwSizeOfUserDataOut,
  [out]     BYTE       **ppUserDataOut,
  [out]     LPWSTR     *ppwszIdentity,
  [out]     EAP_ERROR  **ppEapError
);

パラメーター

[in] dwFlags

EAP 認証セッションの動作を記述する EAP フラグ の組み合わせ。

[in] dwSizeofConnectionData

pConnectionData で提供される接続データ バッファーのサイズをバイト単位で指定します

[in] pConnectionData

不透明な構成データ BLOB を含むバイト バッファーへのポインター。

[in] dwSizeofUserData

pUserData で提供されるユーザー データ バッファーのサイズをバイト単位で指定します。

[in] pUserData

ユーザー データの事前設定に使用される、この認証に固有のユーザー データへのポインター。 この API が初めて呼び出されたとき、または新しい認証セッションが開始されると、このパラメーターは NULL になります。 それ以外の場合は、EapPeerGetResult によって受信した ppResult パラメーターが指す構造体の pUserData メンバーにこのパラメーターを設定します。

[in] hTokenImpersonateUser

認証されるユーザーの偽装トークンへのハンドルを指定します。 このハンドルは、マシン認証を行うときは NULL になります。 このハンドルを使用すると、EAP メソッドは、ユーザー名、ドメイン名、資格情報などのユーザー固有の情報を取得するためにユーザーを偽装できます。

[out] pfInvokeUI

ユーザー ID とユーザー データ BLOB が正常に返されず、メソッドがユーザー インターフェイス ダイアログを通じてユーザーから情報を収集しようとしている場合は TRUE を返します。

[in, out] pdwSizeOfUserDataOut

ppUserDataOut バッファーのサイズをバイト単位で指定します。

[out] ppUserDataOut

返されたユーザー データへのポインターへのポインター。 データは、入力 pUserData として EapPeerBeginSession に渡されます。

[out] ppwszIdentity

返されたユーザー ID へのポインター。 ポインターは ID 応答パケットに含まれ、サーバーに返されます。

[out] ppEapError

この関数呼び出しの実行中に発生したエラーを含む 、EAP_ERROR 構造体へのポインターへのポインター。 エラー データを使用した後、 EapPeerFreeErrorMemory を呼び出してこのメモリを解放する必要があります。

戻り値

なし

解説

この呼び出しは、この API への関数ポインターを使用して、ピア ベースの EAPHost によって実行されます。 この API は、EAPHost によって読み込まれる EAP メソッドに実装する必要があり、ドキュメントで指定されている構文とパラメーターの型に厳密に準拠している必要があります。

要件

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

関連項目

EAPHost ピア メソッド Run-Time 関数

EapPeerInvokeIdentityUI