Funzione WlanGetSupportedDeviceServices (wlanapi.h)

Recupera un elenco dei servizi di dispositivo supportati in un'interfaccia LAN wireless specificata.

Sintassi

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

Parametri

[in] hClientHandle

Tipo: HANDLE

Handle di sessione del client ottenuto da una chiamata precedente alla funzione WlanOpenHandle .

[in] pInterfaceGuid

Tipo: GUID* CONST

Puntatore al GUID dell'interfaccia LAN wireless da eseguire una query. È possibile determinare il GUID di ogni interfaccia LAN wireless abilitata in un computer locale usando la funzione WlanEnumInterfaces .

[out] ppDevSvcGuidList

Tipo: PWLAN_DEVICE_SERVICE_GUID_LIST*

Puntatore all'archiviazione per un puntatore per ricevere l'elenco restituito del GUIDdel servizio dispositivi in una struttura WLAN_DEVICE_SERVICE_GUID_LIST . Se la chiamata ha esito positivo, il buffer per il WLAN_DEVICE_SERVICE_GUID_LIST restituito viene allocato dalla funzione WlanGetSupportedDeviceServices .

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS. Se la funzione ha esito negativo con ERROR_ACCESS_DENIED, il chiamante non dispone di autorizzazioni sufficienti per eseguire questa operazione. Il chiamante deve avere privilegi di amministratore o deve essere un driver UMDF.

Commenti

Se la chiamata ha esito positivo, la funzione WlanGetSupportedDeviceServices alloca la memoria per l'elenco GUID dei servizi dispositivi restituito in un buffer a cui punta il parametro ppDevSvcGuidList . Quando non è più necessario il buffer a cui fa riferimento ppDevSvcGuidList, è necessario rilasciare la memoria usata chiamando la funzione WlanFreeMemory .

Requisiti