IDot11AdHocManager::CommitCreatedNetwork 方法 (adhoc.h)

初始化创建的网络,并选择性地将网络的配置文件提交到配置文件存储区。 在调用 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,则配置文件是一个全用户配置文件,可供登录到计算机的任何用户使用。 如果 fSaveProfileFALSE,则忽略此参数。

默认情况下,只有 Administrators 组的成员才能保留所有用户配置文件。 可以使用 WlanSetSecuritySettings 函数更改这些安全设置。 应用程序必须由具有足够权限的用户启动,才能成功保存所有用户配置文件。

如果应用程序在远程桌面窗口中运行,则只能保存所有用户配置文件。 无法从远程运行的应用程序保存特定于用户的配置文件。

返回值

可能的返回值包括但不限于以下值。

返回代码 说明
S_OK
该方法已成功完成。
E_FAIL
方法失败。
E_INVALIDARG
其中一个参数无效。
E_NOINTERFACE
不支持指定的接口。
E_OUTOFMEMORY
方法无法分配执行此操作所需的内存。
E_POINTER
作为参数传递的指针无效。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 adhoc.h

另请参阅

IDot11AdHocManager

IDot11AdHocManager::CreateNetwork