Skip to content

Latest commit

 

History

History
116 lines (99 loc) · 3.28 KB

nf-wcndevice-iwcndevice-setnetworkprofile.md

File metadata and controls

116 lines (99 loc) · 3.28 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:wcndevice.IWCNDevice.SetNetworkProfile
IWCNDevice::SetNetworkProfile (wcndevice.h)
The IWCNDevice::SetNetworkProfile method queues an XML WLAN profile to be provisioned to the device. This method may only be called prior to IWCNDevice::Connect.
IWCNDevice interface [Windows Connect Now]
SetNetworkProfile method
IWCNDevice.SetNetworkProfile
IWCNDevice::SetNetworkProfile
SetNetworkProfile
SetNetworkProfile method [Windows Connect Now]
SetNetworkProfile method [Windows Connect Now]
IWCNDevice interface
wcn.iwcndevice_setnetworkprofile
wcndevice/IWCNDevice::SetNetworkProfile
wcn\iwcndevice_setnetworkprofile.htm
wcn
267aa55a-005d-4db8-9569-f8ee77a15168
12/05/2018
IWCNDevice interface [Windows Connect Now],SetNetworkProfile method, IWCNDevice.SetNetworkProfile, IWCNDevice::SetNetworkProfile, SetNetworkProfile, SetNetworkProfile method [Windows Connect Now], SetNetworkProfile method [Windows Connect Now],IWCNDevice interface, wcn.iwcndevice_setnetworkprofile, wcndevice/IWCNDevice::SetNetworkProfile
wcndevice.h
Windows
Windows 7 [desktop apps only]
None supported
WcnDevice.idl
Windows
19H1
IWCNDevice::SetNetworkProfile
wcndevice/IWCNDevice::SetNetworkProfile
c++
APIRef
kbSyntax
COM
WcnDevice.h
IWCNDevice.SetNetworkProfile

IWCNDevice::SetNetworkProfile

-description

The IWCNDevice::SetNetworkProfile method queues an XML WLAN profile to be provisioned to the device. This method may only be called prior to IWCNDevice::Connect.

-parameters

-param pszProfileXml [in]

The XML WLAN profile XML string.

-returns

This method can return one of these values.

Return code Description
S_OK
 The attribute was retrieved successfully.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 The WLAN profile is not supported for WCN connections.
HRESULT_FROM_WIN32(ERROR_BAD_PROFILE)
 The provided XML profile cannot be read.

-remarks

Currently, the Windows Connect Now API (WCNAPI) supports the following profile types:

  • None (Open or Shared)
  • WEP (Open or Shared)
  • WPA-PSK (TKIP or AES)
  • WPA2-PSK (TKIP or AES)
If the specified WLAN profile has extraneous settings (like IHV settings), these settings will be ignored. In the event a WLAN profile is not compatible with the WCNAPI, an HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) value is returned.

-see-also

IWCNDevice