EapPeerBeginSession 函式 (eapmethodpeerapis.h)

使用 EAP 方法，在對等 EAPHost 上啟動 EAP 驗證會話。

語法

DWORD EapPeerBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  HANDLE                      hTokenImpersonateUser,
  [in]  DWORD                       dwSizeofConnectionData,
  [in]  BYTE                        *pConnectionData,
  [in]  DWORD                       dwSizeofUserData,
  [in]  BYTE                        *pUserData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

參數

[in] dwFlags

描述新 EAP 驗證會話行為的 EAP 旗標 組合。

[in] pAttributeArray

EAP_ATTRIBUTES陣列結構的指標，指定要驗證之實體的 EAP 屬性。

[in] hTokenImpersonateUser

指定要在此會話中使用的使用者模擬權杖控制碼。

[in] dwSizeofConnectionData

指定 pConnectionData中提供之連接資料緩衝區的大小，以位元組為單位。

[in] pConnectionData

這個方法特有的連線資料，用來決定從此 API 傳回的使用者資料，其中使用者資料取決於特定連線資料組態。 當此參數為 Null 時，方法實作應該使用預設值進行連接。

[in] dwSizeofUserData

指定 pUserData中提供的使用者資料緩衝區位元組大小。

[in] pUserData

位元組緩衝區的指標，其中包含不透明的使用者資料 BLOB。

[in] dwMaxSendPacketSize

指定會話期間傳送之 EAP 封包位元組的大小上限。 如果方法必須傳送大於大小上限的封包，則方法必須容納片段並重新組譯。

[out] pSessionHandle

EAP_SESSION_HANDLE結構的指標，其中包含 EAPHost 伺服器上這個 EAP 驗證會話的唯一控制碼。

[out] ppEapError

指向 EAP_ERROR 結構的指標，其中包含執行此函式呼叫期間引發的任何錯誤。 取用錯誤資料之後，必須呼叫 EapPeerFreeErrorMemory來釋放此記憶體。

傳回值

無

備註

此呼叫是由對等型 EAPHost 使用此 API 的函式指標來執行。 此 API 必須在 EAPHost 載入的 EAP 方法上實作，而且必須嚴格符合檔中指定的語法和參數類型。

需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	eapmethodpeerapis.h

另請參閱

EAPHost 對等方法 Run-Time 函式

EapPeerEndSession

SSO 和 PLAP