EapMethodAuthenticatorBeginSession 函式 (eapmethodauthenticatorapis.h)
在伺服器 EAPHost 上建立新的 EAP 驗證會話。
EapMethodAuthenticatorBeginSession 是函式原型。
語法
DWORD EapMethodAuthenticatorBeginSession(
[in] DWORD dwFlags,
[in] BYTE bInitialId,
LPCWSTR pwszIdentity,
[in] const EapAttributes * const pAttributeArray,
[in] DWORD dwSizeofConnectionData,
const BYTE * const pConnectionData,
[in] DWORD dwMaxSendPacketSize,
[out] EAP_SESSION_HANDLE *pSessionHandle,
[out] EAP_ERROR **ppEapError
);
參數
[in] dwFlags
描述 EAP 驗證會話行為的 EAP 旗標 組合。
[in] bInitialId
以零結尾的 Unicode 字串，其中包含要驗證的使用者身分識別。
pwszIdentity
正在驗證之使用者的身分識別。
[in] pAttributeArray
EapAttributes 陣列結構的指標，指定要驗證之實體的 EAP 屬性。
[in] dwSizeofConnectionData
指定 pConnectionData 所指向之數據的大小，以位元組為單位。 如果 pConnectionData 為 NULL，則此成員為零。
pConnectionData
從驗證通訊協定的組態使用者介面接收之連線數據的指標。
[in] dwMaxSendPacketSize
指定會話期間所傳送 EAP 封包的大小上限，以位元組為單位。
[out] pSessionHandle
EAP_SESSION_HANDLE 結構的指標，其中包含EAPHost伺服器上這個EAP驗證會話的唯一句柄。
[out] ppEapError
選擇性地接收 指標指向EAP_ERROR 結構的指標，這個結構包含此函數調用執行期間 EAPHost 所引發的任何錯誤。 取用錯誤數據之後，必須將錯誤數據的指標傳遞至 EapMethodAuthenticatorFreeMemory，以釋放此記憶體。
傳回值
無
備註
此呼叫是由驗證器型 EAPHost 使用此 API 的函式指標來執行。 此 API 必須在 EAPHost 載入的 EAP 驗證器方法上實作，而且必須嚴格符合檔中指定的語法和參數類型。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | eapmethodauthenticatorapis.h |