WlanGetSupportedDeviceServices 函数 （wlanapi.h）

检索给定无线 LAN 接口上支持的设备服务的列表。

Syntax

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

参数

[in] hClientHandle

类型： HANDLE

客户端的会话句柄，由先前对 WlanOpenHandle 函数的调用获取。

[in] pInterfaceGuid

类型： CONST GUID*

指向要查询的无线 LAN 接口 GUID 的指针。 可以使用 WlanEnumInterfaces 函数确定在本地计算机上启用的每个无线 LAN 接口的 GUID。

[out] ppDevSvcGuidList

类型： PWLAN_DEVICE_SERVICE_GUID_LIST*

指向存储的指针，用于接收WLAN_DEVICE_SERVICE_GUID_LIST结构中返回的设备服务 GUID列表。 如果调用成功，则由 WlanGetSupportedDeviceServices 函数分配返回WLAN_DEVICE_SERVICE_GUID_LIST的缓冲区。

返回值

类型： HRESULT

如果函数成功，则返回值 ERROR_SUCCESS。 如果函数失败并 ERROR_ACCESS_DENIED，则调用方没有足够的权限来执行此作。 调用方需要具有管理员权限，或者需要是 UMDF 驱动程序。

注解

如果调用成功，则 WlanGetSupportedDeviceServices 函数将为 ppDevSvcGuidList 参数指向的缓冲区中返回的设备服务 GUID 列表分配内存。 当不再需要 ppDevSvcGuidList 指向的缓冲区时，应通过调用 WlanFreeMemory 函数释放用于它的内存。

要求