共用方式為

DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES回呼函式 (wlanihv.h)

  • 發行項
重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。 請改用 WLAN 設備驅動器介面 (WDI) 。 如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。

IHV 延伸模組 DLL 會呼叫 Dot11ExtSetVirtualStationAPProperties 函式，以指定目前的 IHV 配置文件連線。

語法

DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES Dot11extSetVirtualStationApProperties;

DWORD Dot11extSetVirtualStationApProperties(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwNumProperties,
  [in]           PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY pProperties,
                 LPVOID pvReserved
)
{...}

參數

[in, optional] hDot11SvcHandle

操作系統用來參考主要實體無線 LAN (WLAN) 適配卡的選擇性句柄。 此句柄值是透過先前對 Dot11ExtIhvInitAdapter IHV Handler 函式的呼叫，接收為 hDot11SvcHandle 參數。

[in, optional] hConnectSession

操作系統用來參考目前聯機會話的句柄，其基本服務集 (BSS) 網路。 此句柄值是透過先前對的呼叫接收為 hConnectSession 參數 Dot11ExtIhvPerformPreAssociate IHV 處理程式函式。

[in] dwNumProperties

pProperties 參數所指向之結構陣列中的元素數目。

[in] pProperties

陣列的指標 DOT11EXT_VIRTUAL_STATION_AP_PROPERTY 結構，指定虛擬 802.11 月台嘗試在目前聯機會話中裝載的存取點屬性 () AP。

pvReserved

此參數會保留供作業系統使用，且應該是 NULL。

傳回值

如果呼叫成功，函式會傳回ERROR_SUCCESS。 否則，它會傳回 Winerror.h 中定義的錯誤碼。

備註

如果目前的 IHV 設定檔連線是存取點 (AP) ，而 IHV 延伸模組 DLL 可以提供給操作系統所使用的設定，則操作系統可以將其他資訊提供給從操作系統要求 AP 相關服務的使用者。

如果 IHV 延伸模組 DLL 呼叫 Dot11ExtSetVirtualStationAPProperties，它必須先這麼做，才能呼叫 Dot11ExtIhvPerformPreAssociate IHV 處理程式函式。 如果在成功完成預先關聯作業之前未呼叫 Dot11ExtSetVirtualStationAPProperties ，則操作系統不會假設 IHV 配置文件的本質。

規格需求

需求 值
最低支援的用戶端 可在 Windows 7 和更新版本的 Windows 作業系統中使用。
目標平台 桌面
標頭 wlanihv.h (包含 Wlanihv.h)

另請參閱

Dot11ExtIhvPerformPreAssociate

Dot11ExtIhvInitAdapter

DOT11EXT_VIRTUAL_STATION_AP_PROPERTY