Função WlanGetSupportedDeviceServices (wlanapi.h)

Recupera uma lista dos serviços de dispositivo com suporte em uma determinada interface lan sem fio.

Sintaxe

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

Parâmetros

[in] hClientHandle

Tipo: HANDLE

O identificador de sessão do cliente, obtido por uma chamada anterior para a função WlanOpenHandle .

[in] pInterfaceGuid

Tipo: CONST GUID*

Um ponteiro para o GUID da interface lan sem fio a ser consultada. Você pode determinar o GUID de cada interface lan sem fio habilitada em um computador local usando a função WlanEnumInterfaces .

[out] ppDevSvcGuidList

Tipo: PWLAN_DEVICE_SERVICE_GUID_LIST*

Um ponteiro para o armazenamento de um ponteiro para receber a lista retornada de GUIDsdo serviço de dispositivo em uma estrutura WLAN_DEVICE_SERVICE_GUID_LIST . Se a chamada for bem-sucedida, o buffer do WLAN_DEVICE_SERVICE_GUID_LIST retornado será alocado pela função WlanGetSupportedDeviceServices .

Retornar valor

Tipo: HRESULT

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS. Se a função falhar com ERROR_ACCESS_DENIED, o chamador não terá permissões suficientes para executar essa operação. O chamador precisa ter privilégio de administrador ou precisa ser um driver UMDF.

Comentários

Se a chamada for bem-sucedida, a função WlanGetSupportedDeviceServices alocará memória para a lista guid de serviços de dispositivo retornada em um buffer apontado pelo parâmetro ppDevSvcGuidList . Quando você não precisar mais do buffer apontado por ppDevSvcGuidList, deverá liberar a memória usada para ele chamando a função WlanFreeMemory .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10 Build 20348
Servidor mínimo com suporte	Windows 10 Build 20348
Cabeçalho	wlanapi.h