作成されたネットワークを初期化し、必要に応じてネットワークのプロファイルをプロファイル ストアにコミットします。 CommitCreatedNetwork を呼び出す前に、CreateNetwork を使用してネットワークを作成する必要があります。
構文
HRESULT CommitCreatedNetwork(
[in] IDot11AdHocNetwork *pIAdHoc,
[in] BOOLEAN fSaveProfile,
[in] BOOLEAN fMakeSavedProfileUserSpecific
);
パラメーター
[in] pIAdHoc
初期化およびコミットするネットワークを指定する IDot11AdHocNetwork インターフェイスへのポインター。
[in] fSaveProfile
ワイヤレス プロファイルを保存するかどうかを指定する省略可能なパラメーター。 TRUE の場合、プロファイルはプロファイル ストアに保存されます。 プロファイルが保存されると、ユーザーは ワイヤレス ネットワークの管理 ユーザー インターフェイスを使用してプロファイルを変更できます。 プロファイルは、 ネイティブ Wifi 関数を使用して変更することもできます。
プロファイルを保存すると、 IDot11AdHocNetwork::GetSignature によって返されるネットワーク署名が変更されます。
[in] fMakeSavedProfileUserSpecific
保存するプロファイルがすべてのユーザー プロファイルかどうかを指定する省略可能なパラメーター。 TRUE に設定した場合、プロファイルは現在のユーザーに固有です。 FALSE に設定されている場合、プロファイルはすべてのユーザー プロファイルであり、コンピューターにログインしているすべてのユーザーが使用できます。 fSaveProfile が FALSE の場合、このパラメーターは無視されます。
既定では、Administrators グループのメンバーのみが、すべてのユーザー プロファイルを保持できます。 これらのセキュリティ設定は、 WlanSetSecuritySettings 関数を使用して変更できます。 アプリケーションは、すべてのユーザー プロファイルを正常に永続化するための十分な特権を持つユーザーによって起動される必要があります。
アプリケーションがリモート デスクトップ ウィンドウで実行されている場合は、すべてのユーザー プロファイルのみを保存できます。 リモートで実行されているアプリケーションからユーザー固有のプロファイルを保存することはできません。
戻り値
可能な戻り値は次のとおりですが、これらに限定されません。
| リターン コード | 説明 |
|---|---|
|
メソッドは正常に完了しました。 |
|
メソッドが失敗しました。 |
|
いずれかのパラメーターが無効です。 |
|
指定されたインターフェイスはサポートされていません。 |
|
メソッドは、この操作を実行するために必要なメモリを割り当てませんでした。 |
|
パラメーターとして渡されたポインターが無効です。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | adhoc.h |