IWCNDevice::SetNetworkProfile 方法 (wcndevice.h)

IWCNDevice::SetNetworkProfile 方法将 XML WLAN 配置文件排队以预配到设备。 只能在 IWCNDevice::Connect 之前调用此方法。

语法

HRESULT SetNetworkProfile(
  [in] LPCWSTR pszProfileXml
);

参数

[in] pszProfileXml

XML WLAN 配置文件 XML 字符串。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
已成功检索属性。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
WCN 连接不支持 WLAN 配置文件。
HRESULT_FROM_WIN32 (ERROR_BAD_PROFILE)
无法读取提供的 XML 配置文件。

注解

目前,Windows 立即连接 API (WCNAPI) 支持以下配置文件类型:

  • 无 (打开或共享)
  • WEP (开放或共享)
  • WPA-PSK (TKIP 或 AES)
  • WPA2-PSK (TKIP 或 AES)
如果指定的 WLAN 配置文件具有与 IHV 设置) (无关的设置,则将忽略这些设置。 如果 WLAN 配置文件与 WCNAPI 不兼容,则返回 HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED) 值。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 wcndevice.h

另请参阅

IWCNDevice