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 |