EapHostPeerGetMethodProperties 函式 (eaphostpeerconfigapis.h)
EapHostPeerGetMethodProperties 函式可用來擷取指定連線和用戶數據之 EAP 方法的屬性。
語法
DWORD EapHostPeerGetMethodProperties(
[in] DWORD dwVersion,
[in] DWORD dwFlags,
[in] EAP_METHOD_TYPE eapMethodType,
[in] HANDLE hUserImpersonationToken,
[in] DWORD dwEapConnDataSize,
[in] const BYTE *pbEapConnData,
[in] DWORD dwUserDataSize,
[in] const BYTE *pbUserData,
[out] EAP_METHOD_PROPERTY_ARRAY *pMethodPropertyArray,
[out] EAP_ERROR **ppEapError
);
參數
[in] dwVersion
API 版本號碼。 將此參數設定為零。
[in] dwFlags
[in] eapMethodType
EAP_METHOD_TYPE 結構,指定要使用的EAP方法。
[in] hUserImpersonationToken
要在此會話中使用的用戶模擬令牌句柄。
[in] dwEapConnDataSize
pbEapConnData 中提供的連線數據緩衝區大小,以位元組為單位。
[in] pbEapConnData
用於 EAP 方法的連接數據。 如果設定為 NULL,則會傳回 方法的靜態屬性,如登錄中所設定。
[in] dwUserDataSize
pbUserData 中提供的用戶數據緩衝區大小,以位元組為單位。
[in] pbUserData
位元組緩衝區的指標,其中包含不透明的用戶數據 BLOB。 此參數可以是 Null。
[out] pMethodPropertyArray
方法屬性陣列 EAP_METHOD_PROPERTY_ARRAY的指標。 呼叫端應該使用 EapHostPeerFreeMemory 從最內部指標開始釋放內部指標。 呼叫端只有在類型為 empvtString 時,才應該釋放 empvString 值。
[out] ppEapError
指向 EAP_ERROR 結構的指標,其中包含執行此函式呼叫期間 EAPHost 所引發的任何錯誤。 取用錯誤數據之後,必須將指標傳遞至 EapHostPeerFreeErrorMemory,以釋放此記憶體。
傳回值
無
備註
EapHostPeerGetMethodProperties 可讓使用者透過 EAPHost supplicant 介面擷取 EAP 方法的屬性。 此 API 所傳回的屬性可能與 EapHostPeerGetMethods 函式所傳回的屬性不同。 EapHostPeerGetMethodProperties 函式會針對特定連線和用戶數據傳回 EAP 方法的屬性。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | eaphostpeerconfigapis.h |
程式庫 | Eappcfg.lib |
Dll | Eappcfg.dll |