IWCNDevice::SetNetworkProfile-Methode (wcndevice.h)

Die IWCNDevice::SetNetworkProfile-Methode stellt ein XML-WLAN-Profil in die Warteschlange, das auf dem Gerät bereitgestellt werden soll. Diese Methode kann nur vor IWCNDevice::Connect aufgerufen werden.

Syntax

HRESULT SetNetworkProfile(
  [in] LPCWSTR pszProfileXml
);

Parameter

[in] pszProfileXml

DIE XML-Zeichenfolge des WLAN-Profils.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Das Attribut wurde erfolgreich abgerufen.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Das WLAN-Profil wird für WCN-Verbindungen nicht unterstützt.
HRESULT_FROM_WIN32(ERROR_BAD_PROFILE)	Das bereitgestellte XML-Profil kann nicht gelesen werden.

Hinweise

Derzeit unterstützt die Windows-Sofortverbindung-API (WCNAPI) die folgenden Profiltypen:

• Keine (Offen oder Freigegeben)
• WEP (Offen oder Freigegeben)
• WPA-PSK (TKIP oder AES)
• WPA2-PSK (TKIP oder AES)

Wenn das angegebene WLAN-Profil über fremde Einstellungen verfügt (z. B. IHV-Einstellungen), werden diese Einstellungen ignoriert. Falls ein WLAN-Profil nicht mit der WCNAPI kompatibel ist, wird ein HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) -Wert zurückgegeben.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	wcndevice.h

Weitere Informationen

IWCNDevice