Fonction WlanGetInterfaceCapability (wlanapi.h)

Article
03/04/2024

La fonction WlanGetInterfaceCapability récupère les fonctionnalités d’une interface.

Syntaxe

DWORD WlanGetInterfaceCapability(
  [in]  HANDLE                     hClientHandle,
  [in]  const GUID                 *pInterfaceGuid,
        PVOID                      pReserved,
  [out] PWLAN_INTERFACE_CAPABILITY *ppCapability
);

Paramètres

[in] hClientHandle

Le handle de session du client, obtenu par un appel précédent à la fonction WlanOpenHandle .

[in] pInterfaceGuid

GUID de cette interface.

pReserved

Réservé pour un usage futur. Doit être défini sur NULL.

[out] ppCapability

Une structure WLAN_INTERFACE_CAPABILITY qui contient des informations sur les fonctionnalités de l’interface spécifiée.

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	hClientHandle a la valeur NULL ou non valide, pInterfaceGuid a la valeur NULL, pReserved n’est pas NULL ou ppCapability est NULL.
ERROR_INVALID_HANDLE	Le handle hClientHandle est introuvable dans la table handle.
ERROR_NOT_SUPPORTED	Cette fonction a été appelée à partir d’une plateforme non prise en charge. Cette valeur sera retournée si cette fonction a été appelée à partir d’un windows XP avec l’API LAN sans fil ou SP3 pour Windows XP avec le client SP2.
RPC_STATUS	Différents codes d’erreur.

Remarques

L’appelant est chargé d’appeler la fonction WlanFreeMemory pour libérer la mémoire allouée à ppCapability.

Configuration requise

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

Partager via