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

另請參閱

EAPHost Authenticator 方法函式

EapHostPeerBeginSession