Fonction WlanGetSupportedDeviceServices (wlanapi.h)

Récupère une liste des services d’appareil pris en charge sur une interface LAN sans fil donnée.

Syntaxe

DWORD WlanGetSupportedDeviceServices(
  [in]  HANDLE                         hClientHandle,
  [in]  const GUID                     *pInterfaceGuid,
  [out] PWLAN_DEVICE_SERVICE_GUID_LIST *ppDevSvcGuidList
);

Paramètres

[in] hClientHandle

Type : HANDLE

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

[in] pInterfaceGuid

Type : GUID* CONST

Pointeur vers le GUID de l’interface LAN sans fil à interroger. Vous pouvez déterminer le GUID de chaque interface LAN sans fil activée sur un ordinateur local à l’aide de la fonction WlanEnumInterfaces .

[out] ppDevSvcGuidList

Type : PWLAN_DEVICE_SERVICE_GUID_LIST*

Pointeur vers le stockage pour qu’un pointeur reçoive la liste retournée des GUIDde service d’appareil dans une structure de WLAN_DEVICE_SERVICE_GUID_LIST . Si l’appel réussit, la mémoire tampon de l’WLAN_DEVICE_SERVICE_GUID_LIST retournée est allouée par la fonction WlanGetSupportedDeviceServices .

Valeur retournée

Type : HRESULT

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS. Si la fonction échoue avec ERROR_ACCESS_DENIED, l’appelant ne dispose pas des autorisations suffisantes pour effectuer cette opération. L’appelant doit disposer de privilèges d’administrateur ou doit être un pilote UMDF.

Remarques

Si l’appel réussit, la fonction WlanGetSupportedDeviceServices alloue de la mémoire pour la liste GUID des services d’appareil retournée dans une mémoire tampon pointée par le paramètre ppDevSvcGuidList . Lorsque vous n’avez plus besoin de la mémoire tampon pointée vers ppDevSvcGuidList, vous devez libérer la mémoire utilisée pour celle-ci en appelant la fonction WlanFreeMemory .

Configuration requise