WlanSaveTemporaryProfile 関数 (wlanapi.h)

WlanSaveTemporaryProfile 関数は、プロファイル ストアに一時プロファイルを保存します。

構文

DWORD WlanSaveTemporaryProfile(
  [in]           HANDLE     hClientHandle,
  [in]           const GUID *pInterfaceGuid,
  [in]           LPCWSTR    strProfileName,
  [in, optional] LPCWSTR    strAllUserProfileSecurity,
  [in]           DWORD      dwFlags,
  [in]           BOOL       bOverWrite,
                 PVOID      pReserved
);

パラメーター

[in] hClientHandle

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

[in] pInterfaceGuid

インターフェイスの GUID。

[in] strProfileName

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

[in, optional] strAllUserProfileSecurity

すべてのユーザー プロファイルのセキュリティ記述子文字列を設定します。 既定では、新しい全ユーザー プロファイルの場合、すべてのユーザーはプロファイルに対する書き込みアクセス権を持っています。 プロファイルのアクセス許可の詳細については、「解説」セクションを参照してください。

dwFlags が WLAN_PROFILE_USER に設定されている場合、このパラメーターは無視されます。

このパラメーターがすべてのユーザー プロファイルに 対して NULL に設定されている場合は、既定のアクセス許可が使用されます。

このパラメーターがすべてのユーザー プロファイルに 対して NULL でない場合は、セキュリティ記述子オブジェクトが作成され、文字列として解析された後に、プロファイルに関連付けられているセキュリティ記述子文字列が作成または変更されます。

[in] dwFlags

プロファイルに設定するフラグを指定します。 フラグを組み合わせることができます。

[in] bOverWrite

このプロファイルが既存のプロファイルを上書きするかどうかを指定します。 このパラメーターが FALSE で、プロファイルが既に存在する場合、既存のプロファイルは上書きされず、エラーが返されます。

pReserved

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

戻り値

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

関数が失敗した場合、戻り値は次のいずれかのリターン コードになります。

注釈

一時的なプロファイルとは、 WlanConnect に渡されるか、検出エンジンによって生成されるプロファイルです。 ネットワーク接続は、一時プロファイルを使用して確立できます。 この API を使用すると、一時的なプロファイルと関連付けられているユーザー データがプロファイル ストアに保存されます。

新しいプロファイルは、グループ ポリシー プロファイルの後の一覧の上部に追加されます。 既存のプロファイルが上書きされた場合、リスト内のプロファイルの位置は変更されません。

すべてのユーザー プロファイルには、読み取り、書き込み、実行の 3 つのアクセス許可が関連付けられています。 ユーザーが読み取りアクセス権を持っている場合、ユーザーはプロファイルのアクセス許可を表示できます。 ユーザーが実行アクセス権を持っている場合、ユーザーは読み取りアクセス権を持ち、ユーザーはプロファイルを使用してネットワークに接続して切断することもできます。 ユーザーが書き込みアクセス権を持っている場合、ユーザーは実行アクセス権を持ち、ユーザーはプロファイルに関連付けられているアクセス許可を変更および削除することもできます。

次に、セキュリティ記述子オブジェクトを作成し、それを文字列として解析する手順について説明します。

1. InitializeSecurityDescriptor を呼び出して、メモリ内にセキュリティ記述子を作成します。
2. SetSecurityDescriptorOwner を呼び出します。
3. InitializeAcl を呼び出して、メモリ内に随意アクセス制御リスト (DACL) を作成します。
4. AddAccessAllowedAce または AddAccessDeniedAce を呼び出して、DACL にアクセス制御エントリ (ACE) を追加します。 必要に応じて、 AccessMask パラメーターを次のビットごとの OR の組み合わせのいずれかに設定します。
   • WLAN_READ_ACCESS
   • WLAN_READ_ACCESS |WLAN_EXECUTE_ACCESS
   • WLAN_READ_ACCESS |WLAN_EXECUTE_ACCESS |WLAN_WRITE_ACCESS
5. SetSecurityDescriptorDacl を呼び出して、DACL をセキュリティ記述子に追加します。
6. 記述子を文字列に変換するには、 ConvertSecurityDescriptorToStringSecurityDescriptor を呼び出します。

要件

こちらもご覧ください

ネイティブ Wifi API のアクセス許可