WlanExtractPsdIEDataList-Funktion (wlanapi.h)

  • Artikel

Die WlanExtractPsdIEDataList-Funktion extrahiert die PSD-Datenliste (Proximity Service Discovery) information element (IE) aus unformatierten IE-Daten, die in einem Beacon enthalten sind.

Syntax

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

Parameter

[in] hClientHandle

Das Sitzungshandle des Clients, das durch einen vorherigen Aufruf der WlanOpenHandle-Funktion abgerufen wurde.

[in] dwIeDataSize

Die Größe des pRawIeData-Parameters in Bytes.

[in] pRawIeData

Die rohen IE-Daten für alle IEs in der Liste.

[in] strFormat

Beschreibt das Format eines PSD IE. Es werden nur IEs mit einem übereinstimmenden Format zurückgegeben.

pReserved

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

[out] ppPsdIEDataList

Ein Zeiger auf eine PWLAN_RAW_DATA_LIST-Struktur , die die formatierte Datenliste enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
 hClientHandle ist NULL oder ungültig, dwIeDataSize ist 0, pRawIeData ist NULL oder pReserved ist nicht NULL.
ERROR_INVALID_HANDLE
 Das Handle hClientHandle wurde in der Handletabelle nicht gefunden.
ERROR_NOT_SUPPORTED
 Diese Funktion wurde von einer nicht unterstützten Plattform aufgerufen. Dieser Wert wird zurückgegeben, wenn diese Funktion von einem Windows XP mit SP3 oder einer WLAN-API für Windows XP mit SP2-Client aufgerufen wurde.
RPC_STATUS
 Verschiedene Fehlercodes.

Hinweise

Weitere Informationen zu PSD-IEs, einschließlich einer Erläuterung des Formats eines IE, finden Sie unter WlanSetPsdIEDataList.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wlanapi.h (wlanapi.h einschließen)
Bibliothek Wlanapi.lib
DLL Wlanapi.dll

Weitere Informationen

WLAN_RAW_DATA_LIST

WlanSetPsdIEDataList