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

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

[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 方法的屬性。

規格需求

另請參閱

EAPHost Supplicant 組態函式