Поделиться через


Функция WlanGetSupportedDeviceServices (wlanapi.h)

Извлекает список поддерживаемых служб устройств в заданном интерфейсе беспроводной локальной сети.

Синтаксис

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

Параметры

[in] hClientHandle

Тип: HANDLE

Дескриптор сеанса клиента, полученный при предыдущем вызове функции WlanOpenHandle .

[in] pInterfaceGuid

Тип: GUID* CONST

Указатель на GUID интерфейса беспроводной локальной сети для запроса. Идентификатор GUID каждого интерфейса беспроводной локальной сети, включенного на локальном компьютере, можно определить с помощью функции WlanEnumInterfaces.

[out] ppDevSvcGuidList

Тип: PWLAN_DEVICE_SERVICE_GUID_LIST*

Указатель на хранилище, чтобы указатель получал возвращенный список GUIDслужбы устройств в WLAN_DEVICE_SERVICE_GUID_LIST структуре. Если вызов выполнен успешно, буфер для возвращаемого WLAN_DEVICE_SERVICE_GUID_LIST выделяется функцией WlanGetSupportedDeviceServices .

Возвращаемое значение

Тип: HRESULT

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS. Если функция завершается сбоем с ERROR_ACCESS_DENIED, вызывающий объект не имеет достаточных разрешений для выполнения этой операции. Вызывающий объект должен иметь права администратора или быть драйвером UMDF.

Комментарии

Если вызов выполнен успешно, функция WlanGetSupportedDeviceServices выделяет память для списка GUID служб устройств, возвращаемого в буфере, на который указывает параметр ppDevSvcGuidList . Если буфер, на который указывает ppDevSvcGuidList, больше не нужен, следует освободить используемую для него память, вызвав функцию WlanFreeMemory .

Требования

Требование Значение
Минимальная версия клиента сборка Windows 10 20348
Минимальная версия сервера сборка Windows 10 20348
Верхняя часть wlanapi.h