WlanSetFilterList 関数 (wlanapi.h)
WlanSetFilterList 関数は、許可/拒否リストを設定します。
構文
DWORD WlanSetFilterList(
[in] HANDLE hClientHandle,
[in] WLAN_FILTER_LIST_TYPE wlanFilterListType,
[in, optional] const PDOT11_NETWORK_LIST pNetworkList,
PVOID pReserved
);
パラメーター
[in] hClientHandle
WlanOpenHandle 関数の以前の呼び出しによって取得されたクライアントのセッション ハンドル。
[in] wlanFilterListType
フィルター リストの種類を指定する WLAN_FILTER_LIST_TYPE 値。 値は 、wlan_filter_list_type_user_permit または wlan_filter_list_type_user_denyである必要があります。 グループ ポリシー定義リストは、この関数を使用して設定できません。
[in, optional] pNetworkList
許可または拒否するネットワークの一覧を含む DOT11_NETWORK_LIST構造体への ポインター。 構造体の dwIndex メンバーは、構造体の dwNumberOfItems メンバーの値より小さい値を持つ必要があります。そうしないと、アクセス違反が発生する可能性があります。
pReserved
将来利用するために予約されています。 NULL に設定する必要があります。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値は次のいずれかのリターン コードになります。
| リターン コード | 説明 |
|---|---|
|
呼び出し元には、フィルター リストを設定するための十分なアクセス許可がありません。
wlanFilterListType をwlan_filter_list_type_user_permit に設定して呼び出されると、WlanSetFilterList は、wlan_secure_permit_list オブジェクトと共に格納されている随意アクセス制御リスト (DACL) を取得します。 wlanFilterListType をwlan_filter_list_type_user_deny に設定して呼び出されると、WlanSetFilterList は、wlan_secure_deny_list オブジェクトと共に格納されている DACL を取得します。 いずれの場合も、DACL に、呼び出し元スレッドのアクセス トークンに対するアクセス許可WLAN_WRITE_ACCESS付与するアクセス制御エントリ (ACE) が含まれていない場合、 WlanSetFilterList は ERROR_ACCESS_DENIEDを返します。 |
|
hClientHandle が NULL または無効であるか、 pReserved が NULL ではありません。 |
|
ハンドル テーブルにハンドル hClientHandle が見つかりませんでした。 |
|
この関数は、サポートされていないプラットフォームから呼び出されました。 この値は、SP3 の Windows XP または SP2 クライアントを使用した Windows XP 用ワイヤレス LAN API からこの関数が呼び出された場合に返されます。 |
|
さまざまなエラー コード。 |
注釈
グループ ポリシーの許可リストと拒否リストは、ユーザーの許可リストと拒否リストよりも優先されます。 つまり、グループ ポリシー拒否リストにネットワークが表示された場合、ユーザーの許可リスト上のネットワークへのアクセスは拒否されます。 同様に、グループ ポリシー許可リストにネットワークが表示されている場合は、ユーザーの拒否リスト上のネットワークへのアクセスが許可されます。 ユーザー リストまたはグループ ポリシー リストにないネットワークは許可されます。
拒否されたネットワークは自動構成で接続できず、表示されているネットワークの一覧には含まれません。 新しいユーザー許可リストと拒否リストは、以前のバージョンのユーザー リストを上書きします。
フィルター リストをクリアするには、pNetworkList パラメーターを NULL に設定するか、dwNumberOfItems メンバーが 0 に設定されているDOT11_NETWORK_LIST構造体へのポインターを渡します。
すべての SSD をフィルター リストに追加するには、DOT11_SSID構造体のuSSIDLength メンバーが 0 に設定されている関連付けられたDOT11_NETWORK構造体を持つDOT11_NETWORK_LIST構造体へのポインターを渡します。
すべての BSS 型をフィルター リストに追加するには、dot11BssType メンバーが dot11_BSS_type_any に設定されている関連付けられたDOT11_NETWORK構造体を持つDOT11_NETWORK_LISTへのポインターを渡します。
netsh wlan add filter コマンドと netsh wlan delete filter コマンドは、コマンド ラインでも同様の機能を提供します。 詳細については、「 ワイヤレス ローカル エリア ネットワーク (wlan) の Netsh コマンド」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wlanapi.h (Wlanapi.h を含む) |
| Library | Wlanapi.lib |
| [DLL] | Wlanapi.dll |