WlanSetProfilePosition 関数 (wlanapi.h)

  • [アーティクル]

WlanSetProfilePosition 関数は、基本設定リストで指定された 1 つのプロファイルの位置を設定します。

構文

DWORD WlanSetProfilePosition(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] LPCWSTR    strProfileName,
  [in] DWORD      dwPosition,
       PVOID      pReserved
);

パラメーター

[in] hClientHandle

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

[in] pInterfaceGuid

インターフェイスの GUID。

[in] strProfileName

プロファイルの名前。 プロファイル名では大文字と小文字が区別されます。 この文字列は NULL で終わる必要があります。

WINDOWS XP SP3 とワイヤレス LAN API for Windows XP SP2: 指定された名前は、ネットワークの SSID から自動的に派生したプロファイル名と一致する必要があります。 インフラストラクチャ ネットワーク プロファイルの場合は、プロファイル名に SSID を指定する必要があります。 アドホック ネットワーク プロファイルの場合、指定された名前はアドホック ネットワークの SSID の後に が -adhoc続く必要があります。

[in] dwPosition

プロファイルをシフトする優先リスト内の位置を示します。 0 (ゼロ) は 、WlanGetProfileList 関数によって返されるリスト内の最初のプロファイルに対応します。

pReserved

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

戻り値

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

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

リターン コード 説明
ERROR_ACCESS_DENIED
 呼び出し元には、プロファイルの位置を変更するための十分なアクセス許可がありません。

WlanSetProfilePosition は、プロファイル リスト内の全ユーザー プロファイルの相対順序を変更する操作を実行する前、またはすべてのユーザー プロファイルをプロファイル リスト内の下位の位置に移動する操作を実行する前に、WlanSetProfilePosition は、wlan_secure_all_user_profiles_order オブジェクトと共に格納されている随意アクセス制御リスト (DACL) を取得します。 DACL に、呼び出し元スレッドのアクセス トークンWLAN_WRITE_ACCESSアクセス許可を付与するアクセス制御エントリ (ACE) が含まれていない場合、 WlanSetProfilePosition は ERROR_ACCESS_DENIEDを返します。
ERROR_INVALID_PARAMETER
 hClientHandle が NULL または無効、 pInterfaceGuid が NULL、 strProfileName が NULL、または pReserved が NULL ではありません。
ERROR_INVALID_HANDLE
 ハンドル テーブルにハンドル hClientHandle が見つかりませんでした。
RPC_STATUS
 さまざまなエラー コード。

注釈

グループ ポリシー プロファイルの位置を変更することはできません。

既定では、Administrators グループのメンバーとしてログオンしているユーザーのみが、すべてのユーザー プロファイルの位置を変更できます。 WlanGetSecuritySettings を呼び出して、すべてのユーザー プロファイルの位置を変更するために必要な実際のユーザー権限を決定します。

コマンド ラインでプロファイルの位置を設定するには、 netsh wlan set profileorder コマンドを使用します。 詳細については、「 ワイヤレス ローカル エリア ネットワーク (wlan) の Netsh コマンド」を参照してください。

WINDOWS XP SP3 とワイヤレス LAN API for Windows XP SP2: アドホック プロファイルは、プロファイル一覧のインフラストラクチャ プロファイルの後に表示されます。 WlanSetProfilePosition を使用してインフラストラクチャ プロファイルの前にアドホック プロファイルを配置しようとすると、WlanSetProfilePosition 呼び出しは成功しますが、ワイヤレス ゼロ構成サービスは、すべてのインフラストラクチャ ネットワーク プロファイルの後にアドホック プロファイルが配置されるようにプロファイルリストを並べ替えます。

ゲスト プロファイル、ワイヤレス プロビジョニング サービス (WPS) 認証を使用したプロファイル、Wi-Fi Protected Access-None (WPA-None) 認証を使用したプロファイルはサポートされていません。 優先プロファイル リストに表示されるこのようなプロファイルは、プロファイル リスト内の固定位置を持っています。 つまり、 WlanSetProfilePosition を使用してその位置を変更することはできません。また、その位置が他のプロファイルの位置変更の影響を受けないことを意味します。

すべてのワイヤレス LAN 機能では、プロファイル操作を実行するときにワイヤレス インターフェイスのインターフェイス GUID が必要です。 ワイヤレス インターフェイスが削除されると、その状態はワイヤレス LAN サービス (WLANSVC) からクリアされ、プロファイル操作は実行できません。

wlanSetProfilePosition 関数は、pInterfaceGuid パラメーターで指定されたワイヤレス インターフェイス (削除された USB ワイヤレス アダプターなど) がシステムから削除された場合、ERROR_INVALID_PARAMETERで失敗する可能性があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista、SP3 を使用した Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wlanapi.h (Wlanapi.h を含む)
Library Wlanapi.lib
[DLL] Wlanapi.dll
再頒布可能パッケージ Sp2 を使用した Windows XP 用ワイヤレス LAN API

こちらもご覧ください

WlanGetProfile

WlanGetProfileList

WlanSetProfile

WlanSetProfileList