IDot11AdHocManager：：CreateNetwork 方法 (adhoc.h)

创建无线即席网络。 其他客户端和主机可以连接到此网络。

语法

HRESULT CreateNetwork(
  [in]  LPCWSTR                     Name,
  [in]  LPCWSTR                     Password,
  [in]  LONG                        GeographicalId,
  [in]  IDot11AdHocInterface        *pInterface,
  [in]  IDot11AdHocSecuritySettings *pSecurity,
  [in]  GUID                        *pContextGuid,
  [out] IDot11AdHocNetwork          **pIAdHoc
);

参数

[in] Name

网络的友好名称。 此字符串应限制为 32 个字符。 SSID 应用作友好名称。 此名称在信标中广播。

[in] Password

用于网络上的计算机或用户身份验证的密码。

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

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

[in] GeographicalId

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

如果接口不符合 802.11d，则忽略此值。 这意味着，如果 IDot11AdHocInterface：：IsDot11d 返回 FALSE，则忽略此值。

如果不确定要使用哪个值，请将 “GeographicalId” 设置为“CTRY_DEFAULT”。 如果使用 CTRY_DEFAULT，则不会强制执行 802.11d 一致性。

[in] pInterface

指向 IDot11AdHocInterface 的可选指针，该接口指定创建新网络的网络接口。 如果此参数为 NULL，则使用第一个未使用的接口。 如果所有接口都在使用中，则使用第一个枚举接口。 在这种情况下，接口上的上一个网络将断开连接。

[in] pSecurity

指向 IDot11AdHocSecuritySettings 接口的 指针，该接口指定网络上使用的安全设置。

[in] pContextGuid

一个可选参数，指定创建网络的应用程序的 GUID。 应用程序可以使用此标识符将 GetIEnumDot11AdHocNetworks 枚举的网络 限制为应用程序创建的网络。 要使此筛选正常工作，所有计算机上的应用程序的所有实例都必须使用相同的 GUID。

[out] pIAdHoc

指向表示所创建网络的 IDot11AdHocNetwork 接口的指针。

返回值

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

注解

成功 调用 CreateNetwork 后，将预配 pIAdHoc 返回的网络对象，但未构造。 对 CommitCreatedNetwork 的 后续调用将初始化网络。 在提交网络之前，不会发送信标。

CreateNetwork 调用后，没有客户端或主机连接到网络。 使用 IDot11AdHocManagerNotificationSink 接口通知应用程序成功和失败的连接尝试。 有关在该接口上注册通知的信息，请参阅 IDot11AdHocManager。

要求

另请参阅

CommitCreatedNetwork

IDot11AdHocManager