WlanGetNetworkBssList 関数 (wlanapi.h)

WlanGetNetworkBssList 関数は、特定のワイヤレス LAN インターフェイス上のワイヤレス ネットワークまたはネットワークの基本的なサービス セット (BSS) エントリの一覧を取得します。

構文

DWORD WlanGetNetworkBssList(
  [in]       HANDLE            hClientHandle,
  [in]       const GUID        *pInterfaceGuid,
  [optional] const PDOT11_SSID pDot11Ssid,
  [in]       DOT11_BSS_TYPE    dot11BssType,
  [in]       BOOL              bSecurityEnabled,
             PVOID             pReserved,
  [out]      PWLAN_BSS_LIST    *ppWlanBssList
);

パラメーター

[in] hClientHandle

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

[in] pInterfaceGuid

照会するワイヤレス LAN インターフェイスの GUID へのポインター。

ローカル コンピューターで有効になっている各ワイヤレス LAN インターフェイスの GUID は、 WlanEnumInterfaces 関数を使用して決定できます。

[optional] pDot11Ssid

BSS リストが要求されるネットワークの SSID を指定する DOT11_SSID 構造体へのポインター。 このパラメーターは省略可能です。 NULL に設定すると、返されるリストには、ワイヤレス LAN インターフェイスで使用可能なすべての BSS エントリが含まれます。

DOT11_SSID構造体へのポインターを指定する場合、DOT11_SSID 構造体のuSSIDLength メンバーで指定される SSID の長さは、Wlantypes.h ヘッダー ファイルで定義DOT11_SSID_MAX_LENGTH以下である必要があります。 さらに、 dot11BssType パラメーターを dot11_BSS_type_infrastructure または dot11_BSS_type_independent に設定し、 bSecurityEnabled パラメーターを指定する必要があります。

[in] dot11BssType

ネットワークの BSS の種類。 このパラメーターは、BSS リストのネットワークの SSID が指定されていない場合は無視されます ( pDot11Ssid パラメーターは NULL です)。

このパラメーターには、Wlantypes.h ヘッダー ファイルで定義されているDOT11_BSS_TYPE列挙で定義されている次のいずれかの値を指定できます。

[in] bSecurityEnabled

ネットワークでセキュリティが有効になっているかどうかを示す 値。 このパラメーターは、BSS リストのネットワークの SSID が指定されている場合にのみ有効です ( pDot11Ssid パラメーターが NULL ではありません)。

pReserved

将来利用するために予約されています。 このパラメーターは NULL に設定する必要があります。

[out] ppWlanBssList

WLAN_BSS_LIST構造体内の BSS エントリの返されたリストを受け取るためのポインターのストレージへのポインター。

呼び出しが成功した場合、返される WLAN_BSS_LIST のバッファーは WlanGetNetworkBssList 関数によって割り当てられます。

戻り値

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

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

注釈

WlanGetNetworkBssList 関数は、特定のインターフェイスでアクセスできる各ワイヤレス ネットワークまたはネットワークの基本的なサービス セットリストを取得します。 各ワイヤレス ネットワークに対して返される情報の一覧には、インフラストラクチャ BSS ネットワークの各アクセス ポイントまたは独立した BSS ネットワーク (アドホック ネットワーク) のネットワーク ピアによって返される情報要素の一覧も含まれています。 情報は、ppWlanBssList パラメーターのWLAN_BSS_LIST構造体へのポインターとして返されます。 WLAN_BSS_LIST構造体には、項目数の後にWLAN_BSS_ENTRY構造体エントリの配列が含まれます。

WlanGetNetworkBssList 関数によって返される情報は、インフラストラクチャ BSS ネットワークのアクセス ポイントまたは独立した BSS ネットワーク (アドホック ネットワーク) のネットワーク ピアによって送信されるため、返される情報は信頼できません。 WLAN_BSS_ENTRY構造体の ulIeOffset メンバーと ulIeSize メンバーは、情報要素データ BLOB 自体のデータではなく、WLAN_BSS_ENTRY構造体内の情報要素データ BLOB のサイズを決定するために使用する必要があります。 WlanGetNetworkBssList 関数は、ulIeOffset メンバーが指す情報要素データ BLOB で返される情報が、ワイヤレス LAN の IEEE 802.11 標準で定義されている有効な情報要素であることを検証しません。

pDot11Ssid パラメーターが (NULL ではなく) 指定されている場合、指定された dot11BssType パラメーターは、インフラストラクチャ BSS ネットワークの場合はdot11_BSS_type_infrastructureに設定するか、独立した BSS ネットワーク (アドホック ネットワーク) の場合はdot11_BSS_type_independentに設定する必要があります。 dot11BssType パラメーターが dot11_BSS_type_any に設定されている場合、WlanGetNetworkBssList 関数はERROR_SUCCESSを返しますが、BSS エントリは返されません。

ワイヤレス LAN インターフェイス上のすべてのインフラストラクチャ BSS ネットワークと独立した BSS ネットワーク (アドホック ネットワーク) の一覧を返すには、 pDot11Ssid パラメーターを NULL に設定 します。 ワイヤレス LAN インターフェイスがワイヤレス ホステッド ネットワークとしても動作している場合、BSS リストには、ワイヤレス ホステッド ネットワーク用に作成された BSS のエントリが含まれます。

WLANGetNetworkBssList 関数は、空の BSS リストが WLAN AutoConfig サービスによって返されたときにERROR_SUCCESSを返します。 WlanGetNetworkBssList 関数を呼び出すアプリケーションでは、ppWlanBssList パラメーターが指すWLAN_BSS_LISTの dwNumberOfItems メンバーが 0 ではないことをチェックしてから、WLAN_BSS_LIST構造体の wlanBssEntries[0] メンバーにアクセスする必要があります。

WlanGetNetworkBssList 関数は、関数が成功したときに ppWlanBssList パラメーターによって指されるバッファーで返される基本的なサービス セット リストにメモリを割り当てます。 ppWlanBssList パラメーターによって指されるバッファーに使用されるメモリは、バッファーが不要になった後に WlanFreeMemory 関数を呼び出すことによって解放する必要があります。

要件

こちらもご覧ください

WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK_LIST

WLAN_BSS_ENTRY

WLAN_BSS_LIST

WlanEnumInterfaces

WlanFreeMemory

WlanGetAvailableNetworkList

WlanScan