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 consultado. 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 de WLAN_DEVICE_SERVICE_GUID_LIST . Se a chamada for bem-sucedida, o buffer para o WLAN_DEVICE_SERVICE_GUID_LIST retornado será alocado pela função WlanGetSupportedDeviceServices .

Valor de retorno

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.

Observações

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 .

Requirements