Méthode IWCNDevice::SetNetworkProfile (wcndevice.h)

La méthode IWCNDevice::SetNetworkProfile met en file d’attente un profil WLAN XML à approvisionner sur l’appareil. Cette méthode ne peut être appelée qu’avant IWCNDevice::Connect.

Syntaxe

HRESULT SetNetworkProfile(
  [in] LPCWSTR pszProfileXml
);

Paramètres

[in] pszProfileXml

Chaîne XML du profil WLAN XML.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	L’attribut a été récupéré avec succès.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Le profil WLAN n’est pas pris en charge pour les connexions WCN.
HRESULT_FROM_WIN32(ERROR_BAD_PROFILE)	Impossible de lire le profil XML fourni.

Remarques

Actuellement, l’API Windows Connect Now (WCNAPI) prend en charge les types de profils suivants :

• Aucun (ouvert ou partagé)
• WEP (ouvert ou partagé)
• WPA-PSK (TKIP ou AES)
• WPA2-PSK (TKIP ou AES)

Si le profil WLAN spécifié a des paramètres superflus (comme les paramètres IHV), ces paramètres sont ignorés. Dans le cas où un profil WLAN n’est pas compatible avec le WCNAPI, une valeur HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) est retournée.

Configuration requise

Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	wcndevice.h

Voir aussi

IWCNDevice