Fonction WFDUpdateDeviceVisibility (wlanapi.h)

Article
03/13/2024

La fonction WFDUpdateDeviceVisibility met à jour la visibilité de l’appareil pour la Wi-Fi adresse de l’appareil direct pour un nœud d’appareil direct installé Wi-Fi donné.

Syntaxe

DWORD WFDUpdateDeviceVisibility(
  PDOT11_MAC_ADDRESS pDeviceAddress
);

Paramètres

pDeviceAddress

Pointeur vers la Wi-Fi adresse directe de l’appareil client.

Cette adresse d’appareil doit être obtenue à partir d’un nœud d’appareil créé à la suite de l’expérience de jumelage de boîte de réception.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour peut être l’un des codes de retour suivants.

Code de retour	Description
ERROR_INVALID_PARAMETER	Le paramètre est incorrect. Cette erreur est retournée si le paramètre pDeviceAddress a la valeur NULL.
ERROR_NOT_ENOUGH_MEMORY	L’espace de stockage disponible est insuffisant pour traiter cette commande.
RPC_STATUS	Différents codes d’erreur.

Remarques

La fonction WFDUpdateDeviceVisibility fait partie de Wi-Fi Direct, une nouvelle fonctionnalité dans Windows 8 et Windows Server 2012. Wi-Fi Direct est basé sur le développement de la spécification technique Wi-Fi pair à pair v1.1 par la Wi-Fi Alliance (voir Spécifications publiées de Wi-Fi Alliance). L’objectif de la spécification technique d’égal à égal Wi-Fi est de fournir une solution pour Wi-Fi connectivité appareil à appareil sans avoir besoin d’un point d’accès sans fil (AP sans fil) pour configurer la connexion ou d’utiliser le mécanisme ibsS (Wi-Fi ad hoc) existant.

La fonction WFDUpdateDeviceVisibility effectue une détection directe Wi-Fi ciblée et met à jour la clé de propriété DEVPKEY_WiFiDirect_IsVisibile sur le nœud de l’appareil pour l’appareil donné.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wlanapi.h
Bibliothèque	Wlanapi.lib
DLL	Wlanapi.dll