WlanRegisterVirtualStationNotification-Funktion (wlanapi.h)

  • Artikel

Die WlanRegisterVirtualStationNotification-Funktion wird verwendet, um Benachrichtigungen auf einer virtuellen Station zu registrieren und aufzuheben.

Syntax

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

Parameter

[in] hClientHandle

Das Sitzungshandle des Clients, das durch einen vorherigen Aufruf der WlanOpenHandle-Funktion abgerufen wurde.

[in] bRegister

Ein Wert, der angibt, ob Benachrichtigungen an einer virtuellen Station empfangen werden sollen.

pReserved

Für die zukünftige Verwendung reserviert. Dieser Parameter muss NULL sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
 Ein Parameter ist falsch. Dieser Fehler wird zurückgegeben, wenn eine der folgenden Bedingungen auftritt:
  • hClientHandle ist NULL.
  • pvReserved ist nicht NULL.
ERROR_INVALID_HANDLE
 Ein Handle ist ungültig. Dieser Fehler wird zurückgegeben, wenn das im hClientHandle-Parameter angegebene Handle nicht in der Handle-Tabelle gefunden wurde.
ERROR_INVALID_STATE
 Die Ressource befindet sich nicht im richtigen Zustand, um den angeforderten Vorgang auszuführen. Dieser Fehler wird zurückgegeben, wenn das drahtlos gehostete Netzwerk durch eine Gruppenrichtlinie für eine Domäne deaktiviert ist.
ERROR_SERVICE_NOT_ACTIVE
 Der Dienst wurde nicht gestartet. Dieser Fehler wird zurückgegeben, wenn der WLAN AutoConfig-Dienst nicht ausgeführt wird.
Andere
 Verschiedene RPC- und andere Fehlercodes. Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die WlanRegisterVirtualStationNotification-Funktion ist eine Erweiterung für native Drahtlos-APIs, die hinzugefügt wurden, um das gehostete Drahtlosnetzwerk unter Windows 7 und windows Server 2008 R2 mit installiertem Wlan-LAN-Dienst zu unterstützen.

Eine Clientanwendung ruft die Funktion WlanRegisterVirtualStationNotification auf, um Benachrichtigungen auf einer virtuellen Station zu registrieren und aufzuheben.

Jede Registrierung zum Empfangen von Benachrichtigungen von einer virtuellen Station, die durch diese Funktion verursacht wird, wird automatisch rückgängig machen, wenn die aufrufende Anwendung den aufrufenden Handle schließt (durch Aufrufen von WlanCloseHandle mit dem hClientHandle-Parameter ) oder wenn der Prozess beendet wird.

Standardmäßig empfängt ein Anwendungsclient keine Benachrichtigungen auf einer virtuellen Station. Um diese Benachrichtigungen zu erhalten, muss ein Client die WlanRegisterVirtualStationNotification-Funktion aufrufen, wobei der bRegister-Parameter auf TRUE festgelegt ist. Außerdem muss die WlanRegisterNotification-Funktion aufgerufen werden, wobei der dwNotifSource-Parameter auf zu registrierende Benachrichtigungsquellen festgelegt ist. Die Registrierung zum Empfangen von Benachrichtigungen von einer virtuellen Station ist wirksam, bis die Anwendung das Clienthandle schließt (durch Aufrufen von WlanCloseHandle mit dem hClientHandle-Parameter ), der Prozess endet oder die WlanRegisterVirtualStationNotification-Funktion aufgerufen wird, wobei der bRegister-Parameter auf FALSE festgelegt ist.

Unter Windows 7 und höher installiert das Betriebssystem ein virtuelles Gerät, wenn auf dem Computer ein gehosteter netzwerkfähiger Drahtlosadapter vorhanden ist. Dieses virtuelle Gerät wird normalerweise im Ordner "Netzwerkverbindungen" als "Drahtlose Netzwerkverbindung 2" mit dem Gerätenamen "Microsoft Virtual WiFi Miniport-Adapter" angezeigt, wenn der Computer über einen einzelnen Drahtlosen Netzwerkadapter verfügt. Dieses virtuelle Gerät wird ausschließlich zum Ausführen von SoftAP-Verbindungen (Software Access Point) verwendet und ist nicht in der Liste enthalten, die von der WlanEnumInterfaces-Funktion zurückgegeben wird. Die Lebensdauer dieses virtuellen Geräts ist an den physischen Drahtlosadapter gebunden. Wenn der physische Drahtlosadapter deaktiviert ist, wird auch dieses virtuelle Gerät entfernt. Dieses Feature ist auch unter Windows Server 2008 R2 verfügbar, wobei der Wireless LAN-Dienst installiert ist.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wlanapi.h (einschließlich Wlanapi.h)
Bibliothek Wlanapi.lib
DLL Wlanapi.dll

Weitere Informationen

Informationen zum drahtlos gehosteten Netzwerk

Verwenden der drahtlos gehosteten Netzwerk- und Internetverbindungsfreigabe

WlanCloseHandle

WlanRegisterNotification