IDot11AdHocManager::CommitCreatedNetwork 方法 (adhoc.h)
初始化已建立的網路,並選擇性地將網路的配置文件認可至配置檔存放區。 必須先使用 CreateNetwork 建立 網路,才能呼叫 CommitCreatedNetwork。
語法
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 |