共用方式為

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 Connect Now API (WCNAPI) 支援下列配置檔案類型：

  • 無 (Open 或 Shared)
  • WEP (Open 或 Shared)
  • WPA-PSK (TKIP 或 AES)
  • WPA2-PSK (TKIP 或 AES)
如果指定的 WLAN 設定檔 (如 IHV 設定) ，則會忽略這些設定。 如果 WLAN 設定檔與 WCNAPI 不相容，則會傳回 HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED) 值。

規格需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 wcndevice.h

另請參閱

IWCNDevice