EAP_AUTHENTICATOR_METHOD_ROUTINES 結構 (eapmethodauthenticatorapis.h)

  • 發行項

包含 EAPHost Authenticator 方法 API 的一組函式指標。

語法

typedef struct _EAP_AUTHENTICATOR_METHOD_ROUTINES {
  DWORD           dwSizeInBytes;
  EAP_METHOD_TYPE *pEapType;
  DWORD(EAP_METHOD_TYPE *pEapType,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorInitialize;
  DWORD(ORD dwFlags,LPCWSTR pwszIdentity, const EapAttributes * const pAttributeArray,DWORD dwSizeofConnectionData, const BYTE * const pConnectionData,DWORD dwMaxSendPacketSize,EAP_SESSION_HANDLE *pSessionHandle,EAP_ERROR **ppEapError)          * )(DWEapMethodAuthenticatorBeginSession;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD dwFlags, const WCHAR *pwszIdentity, const EapAttributes * const pAttributeArray,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorUpdateInnerMethodParams;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD cbReceivePacket, const EapPacket * const pReceivePacket,EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorReceivePacket;
  DWORD(P_SESSION_HANDLE sessionHandle,BYTE bPacketId,DWORD *pcbSendPacket,EapPacket *pSendPacket,EAP_AUTHENTICATOR_SEND_TIMEOUT *pTimeout,EAP_ERROR **ppEapError)          * )(EAEapMethodAuthenticatorSendPacket;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EapAttributes *pAttribs,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorGetAttributes;
  DWORD(AP_SESSION_HANDLE sessionHandle, const EapAttributes * const pAttribs,EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorSetAttributes;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EAP_METHOD_AUTHENTICATOR_RESULT *pResult,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorGetResult;
  DWORD((EAP_SESSION_HANDLE sessionHandle,EAP_ERROR **ppEapError)          * )EapMethodAuthenticatorEndSession;
  DWORD(EAP_METHOD_TYPE *pEapType,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorShutdown;
} EAP_AUTHENTICATOR_METHOD_ROUTINES, *PEAP_AUTHENTICATOR_METHOD_ROUTINES;

成員

dwSizeInBytes

實作器定義的結構版本。

注意 Microsoft 不會定義此欄位的值。
 

pEapType

EAP_METHOD_TYPE 結構的指標 ，其中包含這個結構成員所指向之 API 實作者的廠商資訊。

EapMethodAuthenticatorInitialize

EapMethodAuthenticatorInitialize 的函式指標。

pEapType

EAP_METHOD_TYPE 列舉值，指定要用於此會話的 EAP 驗證類型。

ppEapError

EAP_ERROR 結構的位址 指標，其中包含執行此函式呼叫期間 EAPHost 所引發的任何錯誤。 取用錯誤資料之後，必須將錯誤資料的指標傳遞至 EapPeerFreeErrorMemory，以釋放此記憶體。

EapMethodAuthenticatorBeginSession

EapMethodAuthenticatorBeginSession 的函式指標。

dwFlags

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

pwszIdentity

以零結束的 Unicode 字串，其中包含要驗證之使用者的身分識別。

pAttributeArray

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

dwSizeOfConnectionData

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

pConnectionData

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

dwMaxSendPacketSize

指定會話期間傳送之 EAP 封包的大小上限，以位元組為單位。

pSessionHandle

接收 EAP_SESSION_HANDLE 結構的指標，其中包含伺服器 EAPHost 上新 EAP 驗證會話的唯一識別碼。

ppEapError

EAP_ERROR 結構的位址 指標，其中包含執行此函式呼叫期間 EAPHost 所引發的任何錯誤。 取用錯誤資料之後，必須將錯誤資料的指標傳遞至 EapPeerFreeErrorMemory，以釋放此記憶體。

EapMethodAuthenticatorUpdateInnerMethodParams

EapMethodAuthenticatorUpdateInnerMethodParams的函式指標。

sessionHandle

EAP_SESSION_HANDLE 值，其中包含伺服器 EAPHost 上 EAP 驗證會話的特定控制碼。 這個控制碼是由先前呼叫 EapMethodAuthenticatorBeginSession取得

dwFlags

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

pwszIdentity

以零結束的 Unicode 字串，其中包含要驗證之使用者更新的身分識別。

pAttributeArray

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

ppEapError

EAP_ERROR 結構的位址 指標，其中包含執行此函式呼叫期間引發的任何錯誤。 取用錯誤資料之後，必須將錯誤資料的指標傳遞至 EapMethodAuthenticatorFreeErrorMemory，以釋放此記憶體。

EapMethodAuthenticatorReceivePacket

EapMethodAuthenticatorReceivePacket的函式指標。

sessionHandle

EAP_SESSION_HANDLE 值，其中包含伺服器 EAPHost 上 EAP 驗證會話的特定控制碼。 這個控制碼是由先前呼叫 EapMethodAuthenticatorBeginSession取得

cbReceivePacket

pReceivePacket的大小，以位元組為單位。

pReceivePacket

EapPacket結構的指標，其中包含伺服器 EAPHost 從支援者接收的 EAP 驗證會話封包。

pEapOutput

接收 EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION 列舉值的指標，指出要求必須在 EAP 驗證會話中採取的下一個動作。

ppEapError

EAP_ERROR 結構的位址 指標，其中包含執行此函式呼叫期間 EAPHost 所引發的任何錯誤。 取用錯誤資料之後，必須將錯誤資料的指標傳遞至 EapMethodAuthenticatorFreeErrorMemory，以釋放此記憶體。

EapMethodAuthenticatorSendPacket

EapMethodAuthenticatorSendPacket 的函式指標。

sessionHandle

EAP_SESSION_HANDLE 值，其中包含伺服器 EAPHost 上 EAP 驗證會話的特定控制碼。 這個控制碼是由先前呼叫 EapMethodAuthenticatorBeginSession取得

bPacketId

指定要傳送之封包的數值識別碼值。

azureSendPacket

指定要傳送之封包的大小上限，以位元組為單位。 傳回時，此參數會接收 pEapPacket中傳回之封包的大小，以位元組為單位。

pSendPacket

接收 EapPacket 結構的指標，其中包含要傳送至支援者之封包。

pTimeout

接收指定封包逾時 之EAP_AUTHENTICATOR_SEND_TIMEOUT 值的指標。

ppEapError

EAP_ERROR 結構的位址 指標，其中包含執行此函式呼叫期間引發的任何錯誤。 取用錯誤資料之後，必須將錯誤資料的指標傳遞至EapMethodAuthenticatorFreeErrorMemory，以釋放此記憶體

EapMethodAuthenticatorGetAttributes

EapMethodAuthenticatorGetAttributes的函式指標。

sessionHandle

EAP_SESSION_HANDLE 值，其中包含伺服器 EAPHost 上 EAP 驗證會話的特定控制碼。 這個控制碼是由先前呼叫 EapMethodAuthenticatorBeginSession取得

pAttribs

接收 EapAttributes 結構的指標，其中包含要求之 EAP 驗證回應屬性的陣列。

ppEapError

EAP_ERROR 結構的位址 指標，其中包含執行此函式呼叫期間引發的任何錯誤。 取用錯誤資料之後，必須將錯誤資料的指標傳遞至EapMethodAuthenticatorFreeErrorMemory，以釋放此記憶體

EapMethodAuthenticatorSetAttributes

EapMethodAuthenticatorSetAttributes的函式指標。

sessionHandle

EAP_SESSION_HANDLE 值，其中包含伺服器 EAPHost 上 EAP 驗證會話的特定控制碼。 這個控制碼是由先前呼叫 EapMethodAuthenticatorBeginSession取得

pAttribs

EapAttributes結構的指標，其中包含要針對 EAPHost 上之支援專案設定的新 EAP 驗證回應屬性陣列。

pEapOutput

接收 EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION 列舉值的指標，指定建議者應採取的動作，以回應更新的屬性。

ppEapError

EAP_ERROR 結構的位址 指標，其中包含執行此函式呼叫期間引發的任何錯誤。 取用錯誤資料之後，必須將錯誤資料的指標傳遞至 EapMethodAuthenticatorFreeErrorMemory，以釋放此記憶體。

EapMethodAuthenticatorGetResult

EapMethodAuthenticatorGetResult的函式指標。

sessionHandle

EAP_SESSION_HANDLE 值，其中包含伺服器 EAPHost 上 EAP 驗證會話的特定控制碼。 這個控制碼是由先前呼叫 EapMethodAuthenticatorBeginSession取得

pResult

接收包含驗證結果 之EAP_METHOD_AUTHENTICATOR_RESULT 結構的指標。

ppEapError

EAP_ERROR 結構的位址 指標，其中包含執行此函式呼叫期間 EAPHost 所引發的任何錯誤。 取用錯誤資料之後，必須將錯誤資料的指標傳遞至 EapMethodAuthenticatorFreeErrorMemory，以釋放此記憶體。

EapMethodAuthenticatorEndSession

EapMethodAuthenticatorEndSession的函式指標。

sessionHandle

EAP_SESSION_HANDLE 值，其中包含在伺服器 EAPHost 上關閉之 EAP 驗證會話的特定控制碼。 這個控制碼是由 先前呼叫 EapMethodAuthenticatorBeginSession取得。

ppEapError

EAP_ERROR 結構的位址 指標，其中包含執行此函式呼叫期間 EAPHost 所引發的任何錯誤。 取用錯誤資料之後，必須將錯誤資料的指標傳遞至 EapMethodAuthenticatorFreeErrorMemory，以釋放此記憶體。

EapMethodAuthenticatorShutdown

EapMethodAuthenticatorShutdown的函式指標。

pEapType

EAP_METHOD_TYPE列舉值，指定會話中使用的 EAP 驗證類型。

ppEapError

EAP_ERROR 結構的位址 指標，其中包含執行此函式呼叫期間引發的任何錯誤。 取用錯誤資料之後，必須將錯誤資料的指標傳遞至 EapMethodAuthenticatorFreeErrorMemory，以釋放此記憶體。

備註

每個 EAP 驗證器方法 DLL 都必須有下列 API 的公用實作。

當驗證器 (伺服器) EAPHost 收到來自對等 (用戶端) EAP 方法的特定對應遠端程序呼叫時，會在 EAP 驗證器方法上呼叫這些 API。 請注意，EAP 對等方法與 EAP 驗證器方法之間不存在完整的一對一對應;您必須根據實作 EAP 驗證器方法 API 呼叫的需求，進行特定的 EAP 驗證器方法 API 呼叫。

需求

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

另請參閱

EAPHost Authenticator 方法結構

EapMethodAuthenticatorGetInfo