eapPeerGetInfo 函式 (eapmethodpeerapis.h)

取得 EAP 對等方法 EapPeerGetInfo 目前載入 EAPHost 服務之實作的一組函式指標。

語法

DWORD EapPeerGetInfo(
  [in]  EAP_TYPE                 *pEapType,
  [out] EAP_PEER_METHOD_ROUTINES *pEapInfo,
  [out] EAP_ERROR                **ppEapError
);

參數

[in] pEapType

EAP_TYPE 結構的指標，其中包含這個結構成員所指向之 API 實作者上的廠商數據。

[out] pEapInfo

EAP_PEER_METHOD_ROUTINES 結構的指標，其中包含對應至對等式 EAPHost 呼叫的 EAP 方法特定實作之 EAP 方法特定實作的函式指標。

[out] ppEapError

指向EAP_ERROR結構的指標，這個結構會在執行這個函數調用期間收到任何錯誤。 取用錯誤數據之後，必須呼叫 EapPeerFreeErrorMemory 來釋放此記憶體。

傳回值

無

備註

每個 EAP 對等方法 DLL 都必須實作下列 API：

• EapPeerInitialize
• EapPeerBeginSession
• EapPeerGetIdentity
• EapPeerSetCredentials
• EapPeerProcessRequestPacket
• EapPeerGetResponsePacket
• EapPeerGetResult
• EapPeerGetUIContext
• EapPeerSetUIContext
• EapPeerGetResponseAttributes
• EapPeerSetResponseAttributes
• EapPeerEndSession
• EapPeerShutdown

這些 API 會對應至要求者所進行的呼叫，並做為要求者 API 呼叫與 EAP 方法 DLL 上公開之公用 API 之間的 Proxy。 因此，當成功者呼叫對對等型 EAPHost 進行呼叫以建立驗證會話或在會話期間執行作業時，EAPHost 會使用提供的參數，在 EAP 方法 DLL 上呼叫對應的實作函式。 EAP 方法函式是由其個別進入點的指標所管理。

EAP 對等方法 API 集合中的其他函式是由對等型 EAPHost 呼叫，而不需要對應的支援呼叫，並用於連線驗證或使用者介面調用作業。

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

規格需求

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

另請參閱

EAPHost 對等方法 Run-Time 函式