WlanGetFilterList 関数 (wlanapi.h)
WlanGetFilterList 関数は、グループ ポリシーまたはユーザーのアクセス許可リストを取得します。
構文
DWORD WlanGetFilterList(
[in] HANDLE hClientHandle,
[in] WLAN_FILTER_LIST_TYPE wlanFilterListType,
PVOID pReserved,
[out] PDOT11_NETWORK_LIST *ppNetworkList
);
パラメーター
[in] hClientHandle
WlanOpenHandle 関数の以前の呼び出しによって取得されたクライアントのセッション ハンドル。
[in] wlanFilterListType
フィルター リストの種類を指定する WLAN_FILTER_LIST_TYPE 値。 すべてのユーザー定義およびグループ ポリシー フィルター リストに対してクエリを実行できます。
pReserved
将来利用するために予約されています。 NULL に設定する必要があります。
[out] ppNetworkList
許可または拒否されたネットワークの一覧を含む DOT11_NETWORK_LIST構造体への ポインター。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値は次のいずれかのリターン コードになります。
リターン コード | 説明 |
---|---|
|
呼び出し元には、フィルター リストを取得するための十分なアクセス許可がありません。
wlanFilterListType をwlan_filter_list_type_user_permit に設定して呼び出されると、WlanGetFilterList は、wlan_secure_permit_list オブジェクトと共に格納されている随意アクセス制御リスト (DACL) を取得します。 wlanFilterListType をwlan_filter_list_type_user_deny に設定して呼び出されると、WlanGetFilterList は、wlan_secure_deny_list オブジェクトと共に格納されている DACL を取得します。 いずれの場合も、DACL に、呼び出し元スレッドのアクセス トークンに対するアクセス許可WLAN_READ_ACCESS付与するアクセス制御エントリ (ACE) が含まれていない場合、 WlanGetFilterList は ERROR_ACCESS_DENIEDを返します。 |
|
hClientHandle が NULL であるか無効か、 ppNetworkList が NULL であるか、 pReserved が NULL ではありません。 |
|
ハンドル テーブルにハンドル hClientHandle が見つかりませんでした。 |
|
この関数は、サポートされていないプラットフォームから呼び出されました。 この値は、SP3 の Windows XP または SP2 クライアントを使用した Windows XP 用ワイヤレス LAN API からこの関数が呼び出された場合に返されます。 |
|
さまざまなエラー コード。 |
注釈
ユーザーのアクセス許可リストは、 WlanSetFilterList を呼び出すことによって設定できます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wlanapi.h (Wlanapi.h を含む) |
Library | Wlanapi.lib |
[DLL] | Wlanapi.dll |