通过

IDot11AdHocNetwork：：Connect 方法 (adhoc.h)

  • 项目

连接到以前创建的无线即席网络。 必须先使用 IDot11AdHocManager：：CreateNetwork 创建网络并使用 IDot11AdHocManager：：CommitCreatedNetwork 提交网络，应用程序才能连接到网络。

语法

HRESULT Connect(
  [in] LPCWSTR Passphrase,
  [in] LONG    GeographicalId,
  [in] BOOLEAN fSaveProfile,
  [in] BOOLEAN fMakeSavedProfileUserSpecific
);

参数

[in] Passphrase

用于对网络上的用户或计算机进行身份验证的密码字符串。

密码字符串的长度取决于在 CreateNetwork 调用的 pSecurity 参数中传递的安全设置。 下表显示了与各种安全设置关联的密码长度。

安全设置 密码长度
Open-None 0
Open-WEP 5 或 13 个字符;10 或 26 个十六进制数字
WPA2PSK 8 到 63 个字符
 

有关与上述安全设置对对应的枚举值，请参阅 DOT11_ADHOC_AUTH_ALGORITHM 和 DOT11_ADHOC_CIPHER_ALGORITHM。

[in] GeographicalId

在其中创建网络的地理位置。 有关可能值的列表，请参阅 地理位置表。

[in] fSaveProfile

一个可选参数，指定是否应保存无线配置文件。 如果 为 TRUE，则配置文件将保存到配置文件存储中。 保存配置文件后，用户可以使用 “管理无线网络 ”用户界面修改配置文件。 也可以使用 本机 Wifi 函数修改配置文件。

保存配置文件会修改 IDot11AdHocNetwork：：GetSignature 返回的网络签名。

[in] fMakeSavedProfileUserSpecific

一个可选参数，指定要保存的配置文件是否为全用户配置文件。 如果设置为 TRUE，则配置文件特定于当前用户。 如果设置为 FALSE，则配置文件是一个全用户配置文件，可供登录到计算机的任何用户使用。 如果 fSaveProfile 为 FALSE，则忽略此参数。

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

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

返回值

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

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

注解

此方法是异步方法。 如果传递给方法的参数有效，则 Connect 将立即返回S_OK。 但是，S_OK的返回代码并不表示连接成功。 必须注册 IDot11AdHocNetworkNotificationSink 接口上的通知，才能收到连接成功或失败的通知。 IDot11AdHocNetworkNotificationSink：：OnStatusChange 方法返回连接状态。 有关注册通知的详细信息，请参阅 IDot11AdHocManager。

要求

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

另请参阅

IDot11AdHocNetwork

IDot11AdHocNetwork：:D isconnect