WlanExtractPsdIEDataList function

The WlanExtractPsdIEDataList function extracts the proximity service discovery (PSD) information element (IE) data list from raw IE data included in a beacon.

Syntax

DWORD WlanExtractPsdIEDataList(
  HANDLE              hClientHandle,
  DWORD               dwIeDataSize,
  const PBYTE         pRawIeData,
  LPCWSTR             strFormat,
  PVOID               pReserved,
  PWLAN_RAW_DATA_LIST *ppPsdIEDataList
);

Parameters

hClientHandle

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

dwIeDataSize

The size, in bytes, of the pRawIeData parameter.

pRawIeData

The raw IE data for all IEs in the list.

strFormat

Describes the format of a PSD IE. Only IEs with a matching format are returned.

pReserved

Reserved for future use. Must be set to NULL.

ppPsdIEDataList

A pointer to a PWLAN_RAW_DATA_LIST structure that contains the formatted data list.

Return Value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value may be one of the following return codes.

Return code Description
ERROR_INVALID_PARAMETER
hClientHandle is NULL or invalid, dwIeDataSize is 0, pRawIeData is NULL, or pReserved is not NULL.
ERROR_INVALID_HANDLE
The handle hClientHandle was not found in the handle table.
ERROR_NOT_SUPPORTED
This function was called from an unsupported platform. This value will be returned if this function was called from a Windows XP with SP3 or Wireless LAN API for Windows XP with SP2 client.
RPC_STATUS
Various error codes.

Remarks

For more information about PSD IEs, including a discussion of the format of an IE, see WlanSetPsdIEDataList.

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header wlanapi.h (include Wlanapi.h)
Library Wlanapi.lib
DLL Wlanapi.dll

See Also

WLAN_RAW_DATA_LIST

WlanSetPsdIEDataList