WlanRegisterVirtualStationNotification-Funktion (wlanapi.h)
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 |
|---|---|
|
Ein Parameter ist falsch. Dieser Fehler wird zurückgegeben, wenn eine der folgenden Bedingungen auftritt:
|
|
Ein Handle ist ungültig. Dieser Fehler wird zurückgegeben, wenn das im hClientHandle-Parameter angegebene Handle nicht in der Handle-Tabelle gefunden wurde. |
|
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. |
|
Der Dienst wurde nicht gestartet. Dieser Fehler wird zurückgegeben, wenn der WLAN AutoConfig-Dienst nicht ausgeführt wird. |
|
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