WlanExtractPsdIEDataList 関数 (wlanapi.h)

WlanExtractPsdIEDataList 関数は、ビーコンに含まれる生 IE データから近接サービス探索 (PSD) 情報要素 (IE) データ リストを抽出します。

構文

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

パラメーター

[in] hClientHandle

WlanOpenHandle 関数の以前の呼び出しによって取得されたクライアントのセッション ハンドル。

[in] dwIeDataSize

pRawIeData パラメーターのサイズ (バイト単位)。

[in] pRawIeData

一覧内のすべての IEs の生 IE データ。

[in] strFormat

PSD IE の形式について説明します。 一致する形式の IDE のみが返されます。

pReserved

将来利用するために予約されています。 NULL に設定する必要があります。

[out] ppPsdIEDataList

書式設定されたデータ リストを含む PWLAN_RAW_DATA_LIST 構造体へのポインター。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は次のいずれかの戻りコードになる可能性があります。

リターン コード	説明
ERROR_INVALID_PARAMETER	hClientHandle が NULL または無効、 dwIeDataSize が 0、 pRawIeData が NULL、または pReserved が NULL ではありません。
ERROR_INVALID_HANDLE	ハンドル テーブルにハンドル hClientHandle が見つかりませんでした。
ERROR_NOT_SUPPORTED	この関数は、サポートされていないプラットフォームから呼び出されました。 この関数が SP3 の Windows XP から呼び出された場合、または SP2 クライアントを使用した Windows XP 用ワイヤレス LAN API から呼び出された場合、この値が返されます。
RPC_STATUS	さまざまなエラー コード。

解説

IE の形式の説明など、PSD IEs の詳細については、「 WlanSetPsdIEDataList」を参照してください。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	wlanapi.h (Wlanapi.h を含む)
Library	Wlanapi.lib
[DLL]	Wlanapi.dll

関連項目

WLAN_RAW_DATA_LIST

WlanSetPsdIEDataList