WlanExtractPsdIEDataList function (wlanapi.h)
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 |
|---|---|
|
hClientHandle is NULL or invalid, dwIeDataSize is 0, pRawIeData is NULL, or pReserved is not NULL. |
|
The handle hClientHandle was not found in the handle table. |
|
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. |
|
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 |