WlanGetSupportedDeviceServices function (wlanapi.h)

Retrieves a list of the supported device services on a given wireless LAN interface.

Syntax

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

Parameters

[in] hClientHandle

Type: HANDLE

The client's session handle, obtained by a previous call to the WlanOpenHandle function.

[in] pInterfaceGuid

Type: CONST GUID*

A pointer to the GUID of the wireless LAN interface to be queried. You can determine the GUID of each wireless LAN interface enabled on a local computer by using the WlanEnumInterfaces function.

[out] ppDevSvcGuidList

Type: PWLAN_DEVICE_SERVICE_GUID_LIST*

A pointer to storage for a pointer to receive the returned list of device service GUIDs in a WLAN_DEVICE_SERVICE_GUID_LIST structure. If the call succeeds, then the buffer for the WLAN_DEVICE_SERVICE_GUID_LIST returned is allocated by the WlanGetSupportedDeviceServices function.

Return value

Type: HRESULT

If the function succeeds, the return value is ERROR_SUCCESS. If the function fails with ERROR_ACCESS_DENIED, then the caller doesn't have sufficient permissions to perform this operation. The caller needs to either have admin privilege, or needs to be a UMDF driver.

Remarks

If the call succeeds, then the WlanGetSupportedDeviceServices function allocates memory for the device services GUID list that's returned in a buffer pointed to by the ppDevSvcGuidList parameter. When you no longer need the buffer pointed to by ppDevSvcGuidList, you should release the memory used for it by calling the WlanFreeMemory function.

Requirements