WFDUpdateDeviceVisibility-Funktion (wlanapi.h)
Die WFDUpdateDeviceVisibility-Funktion aktualisiert die Gerätesichtbarkeit für die Wi-Fi Direct-Geräteadresse für einen bestimmten installierten Wi-Fi Direct-Geräteknoten.
Syntax
DWORD WFDUpdateDeviceVisibility(
PDOT11_MAC_ADDRESS pDeviceAddress
);
Parameter
pDeviceAddress
Ein Zeiger auf die Wi-Fi Direkte Geräteadresse des Clientgeräts.
Diese Geräteadresse muss von einem Geräteknoten abgerufen werden, der als Ergebnis der Posteingangskopplung erstellt wurde.
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 |
|---|---|
|
„Der Parameter ist falsch.“
Dieser Fehler wird zurückgegeben, wenn der pDeviceAddress-ParameterNULL ist. |
|
Für die Verarbeitung dieses Befehls steht nicht genügend Speicherplatz zur Verfügung. |
|
Verschiedene Fehlercodes. |
Hinweise
Die WFDUpdateDeviceVisibility-Funktion ist Teil von Wi-Fi Direct, einem neuen Feature in Windows 8 und Windows Server 2012. Wi-Fi Direct basiert auf der Entwicklung der Wi-Fi Peer-to-Peer Technical Specification v1.1 durch die Wi-Fi Alliance (siehe Wi-Fi Alliance Published Specifications). Das Ziel der Wi-Fi Peer-to-Peer Technical Specification besteht darin, eine Lösung für Wi-Fi Geräte-zu-Gerät-Konnektivität bereitzustellen, ohne dass ein Drahtloser Zugriffspunkt (Wireless Access Point, Drahtloser AP) zum Einrichten der Verbindung oder die Verwendung des vorhandenen Wi-Fi Adhoc-Mechanismus (IBSS) erforderlich ist.
Die WFDUpdateDeviceVisibility-Funktion führt eine gezielte Wi-Fi Direct-Ermittlung aus und aktualisiert den DEVPKEY_WiFiDirect_IsVisibile-Eigenschaftenschlüssel auf dem Geräteknoten für das angegebene Gerät.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wlanapi.h |
| Bibliothek | Wlanapi.lib |
| DLL | Wlanapi.dll |