WlanExtractPsdIEDataList function (wlanapi.h)

Article
10/13/2021

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(
  [in]  HANDLE              hClientHandle,
  [in]  DWORD               dwIeDataSize,
  [in]  const PBYTE         pRawIeData,
  [in]  LPCWSTR             strFormat,
        PVOID               pReserved,
  [out] PWLAN_RAW_DATA_LIST *ppPsdIEDataList
);

Parameters

[in] hClientHandle

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

[in] dwIeDataSize

The size, in bytes, of the pRawIeData parameter.

[in] pRawIeData

The raw IE data for all IEs in the list.

[in] 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.

[out] 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

Requirement	Value
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