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 参数中传递的安全设置。 下表显示了与各种安全设置关联的密码长度。

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

 

有关与上述安全设置对对应的枚举值，请参阅 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 接口的指针。

返回值

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

返回代码	说明
S_OK	该方法已成功完成。
E_FAIL	方法失败。
E_INVALIDARG	其中一个参数无效。
E_NOINTERFACE	不支持指定的接口。
E_OUTOFMEMORY	方法无法分配执行此操作所需的内存。
E_POINTER	作为参数传递的指针无效。
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)	已存在具有指定 名称 的网络。
HRESULT_FROM_WIN32 (ERROR_NOT_READY)	pInterface 接口报告其无线电已关闭。
HRESULT_FROM_WIN32 (ERROR_NOT_CAPABLE)	pInterface 接口报告它无法形成临时网络。 出现这种情况的原因可能是 NIC 不支持即席网络，或者 NIC 不支持 pSecurity 提供的安全设置。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	pInterface 接口不支持 pSecurity 设置。
HRESULT_FROM_WIN32 (ERROR_ILL_FORMED_PASSWORD)	提供 的密码 无效。 对于 pSecurity 提供的安全设置，提供的密码长度可能无效。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	计算机上找不到无线网络接口卡。
HRESULT_FROM_WIN32 (ERROR_CURRENT_DOMAIN_NOT_ALLOWED)	组策略或管理设置禁止创建网络。

注解

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

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

要求

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

另请参阅

CommitCreatedNetwork

IDot11AdHocManager