Partager via

Fonction WlanGetInterfaceCapability (wlanapi.h)

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
  • Last updated on