DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES回呼函式 (wlanihv.h)

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 配置文件的本質。

規格需求

另請參閱

Dot11ExtIhvInitAdapter