共用方式為

WlanRegisterVirtualStationNotification 函式 (wlanapi.h)

  • 發行項

WlanRegisterVirtualStationNotification函式可用來在虛擬網路站上註冊和取消註冊通知。

語法

DWORD WlanRegisterVirtualStationNotification(
  [in] HANDLE hClientHandle,
  [in] BOOL   bRegister,
       PVOID  pReserved
);

參數

[in] hClientHandle

用戶端的會話控制碼，由先前呼叫 WlanOpenHandle 函式取得。

[in] bRegister

值，指定是否要在虛擬網路站上接收通知。

pReserved

保留供未來使用。 此參數必須是 Null。

傳回值

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

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

傳回碼 描述
ERROR_INVALID_PARAMETER
 參數不正確。 如果發生下列任一狀況，就會傳回此錯誤：
  • hClientHandle 為 Null。
  • pvReserved 不是 Null。
ERROR_INVALID_HANDLE
 控制碼無效。 如果在控制碼資料表中找不到 hClientHandle 參數中指定的控制碼，就會傳回此錯誤。
ERROR_INVALID_STATE
 資源未處於執行要求作業的正確狀態。 如果網域上的群組原則停用無線託管網路，就會傳回此錯誤。
ERROR_SERVICE_NOT_ACTIVE
 尚未啟動服務。 如果 WLAN 自動設定服務未執行，則會傳回此錯誤。
其他
 各種 RPC 和其他錯誤碼。 使用 FormatMessage 取得傳回錯誤的訊息字串。

備註

WlanRegisterVirtualStationNotification函式是新增的原生無線 API 擴充功能，可支援 Windows 7 和 Windows Server 2008 R2 上安裝無線區域網路 服務的無線託管網路。

用戶端應用程式會呼叫 WlanRegisterVirtualStationNotification 函式，以在虛擬網路站上註冊和取消註冊通知。

如果呼叫應用程式使用hClientHandle 參數呼叫 WlanCloseHandle，) 或進程結束，則從此函式所造成的虛擬站接收通知的任何註冊都會自動復原 (。

根據預設，應用程式用戶端不會在虛擬網路站上收到通知。 若要接收這些通知，用戶端必須呼叫 WlanRegisterVirtualStationNotification 函式，並將 bRegister 參數設定為 TRUE ，而且也必須呼叫 WlanRegisterNotification 函式，並將 dwNotifSource 參數設定為要註冊的通知來源。 從虛擬網路接收通知的註冊會生效，直到應用程式使用hClientHandle參數呼叫WlanCloseHandle) 、進程結束或WlanRegisterVirtualStationNotification函式呼叫bRegister參數設為FALSE，以關閉用戶端控制碼 (。

在 Windows 7 和更新版本上，如果電腦上存在支援託管網路的無線介面卡，作業系統就會安裝虛擬裝置。 如果電腦具有單一無線網路介面卡，此虛擬裝置通常會顯示在「網路連線資料夾」中顯示為「無線網路連線 2」，且裝置名稱為 「Microsoft Virtual WiFi Miniport 配接器」。 此虛擬裝置專門用來執行軟體存取點 (SoftAP) 連線，而且不會出現在 WlanEnumInterfaces 函式所傳回的清單中。 此虛擬裝置的存留期會系結至實體無線介面卡。 如果實體無線介面卡已停用，也會移除此虛擬裝置。 此功能也適用于已安裝無線區域網路 服務的 Windows Server 2008 R2。

規格需求

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

另請參閱

關於無線託管網路

使用無線裝載的網路和網際網路連線共用

WlanCloseHandle

WlanRegisterNotification