共用方式為

WlanGetInterfaceCapability 函式 (wlanapi.h)

  • 發行項

WlanGetInterfaceCapability 函式會擷取介面的功能。

語法

DWORD WlanGetInterfaceCapability(
  [in]  HANDLE                     hClientHandle,
  [in]  const GUID                 *pInterfaceGuid,
        PVOID                      pReserved,
  [out] PWLAN_INTERFACE_CAPABILITY *ppCapability
);

參數

[in] hClientHandle

用戶端的會話句柄，由先前呼叫 WlanOpenHandle 函式取得。

[in] pInterfaceGuid

這個介面的 GUID。

pReserved

保留供未來使用。 必須設定為 NULL。

[out] ppCapability

包含指定介面功能相關信息 的WLAN_INTERFACE_CAPABILITY 結構。

傳回值

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值可能是下列其中一個傳回碼。

傳回碼 Description
ERROR_INVALID_PARAMETER
 hClientHandle 為 NULL 或無效，pInterfaceGuid 為 NULL、pReserved 不是 NULL，或 ppCapability 為 NULL。
ERROR_INVALID_HANDLE
 句柄數據表中找不到句柄 hClientHandle 。
ERROR_NOT_SUPPORTED
 從不支援的平臺呼叫此函式。 如果使用SP2用戶端從具有SP3的Windows XP或適用於Windows XP的無線LAN API 呼叫此函式，將會傳回此值。
RPC_STATUS
 各種錯誤碼。

備註

呼叫端負責呼叫 WlanFreeMemory 函式 ，以釋放配置給 ppCapability 的記憶體。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wlanapi.h (包含 Wlanapi.h)
程式庫 Wlanapi.lib
Dll Wlanapi.dll