WlanSetProfileList-Funktion (wlanapi.h)

  • Artikel

Die WlanSetProfileList-Funktion legt die Voreinstellungsreihenfolge von Profilen für eine bestimmte Schnittstelle fest.

Syntax

DWORD WlanSetProfileList(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] DWORD      dwItems,
  [in] LPCWSTR    *strProfileNames,
       PVOID      pReserved
);

Parameter

[in] hClientHandle

Das Sitzungshandle des Clients, das durch einen vorherigen Aufruf der WlanOpenHandle-Funktion abgerufen wurde.

[in] pInterfaceGuid

Die GUID der Schnittstelle.

[in] dwItems

Die Anzahl der Profile im strProfileNames-Parameter .

[in] strProfileNames

Die Namen der Profile in der gewünschten Reihenfolge. Bei Profilnamen wird die Groß-/Kleinschreibung beachtet. Diese Zeichenfolge muss NULL-beendet sein.

Windows XP mit SP3 und WLAN-API für Windows XP mit SP2: Die angegebenen Namen müssen mit den Profilnamen übereinstimmen, die automatisch von der SSID des Netzwerks abgeleitet werden. Für Infrastrukturnetzwerkprofile muss die SSID für den Profilnamen angegeben werden. Für Ad-hoc-Netzwerkprofile muss der angegebene Name die SSID des Ad-hoc-Netzwerks sein, gefolgt von -adhoc.

pReserved

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Rückgabecode Beschreibung
ERROR_ACCESS_DENIED
 Der Aufrufer verfügt nicht über ausreichende Berechtigungen zum Ändern der Profilliste.

Bevor WlanSetProfileList einen Vorgang ausführt, der die relative Reihenfolge aller Benutzerprofile in der Profilliste ändert oder ein Benutzerprofil an eine niedrigere Position in der Profilliste verschiebt, ruft WlanSetProfileList die diskretionäre Zugriffssteuerungsliste (DACL) ab, die mit dem wlan_secure_all_user_profiles_order-Objekt gespeichert ist. Wenn die DACL keinen Zugriffssteuerungseintrag (Access Control Entry, ACE) enthält, der WLAN_WRITE_ACCESS Berechtigung für das Zugriffstoken des aufrufenden Threads gewährt, gibt WlanSetProfileListERROR_ACCESS_DENIED zurück.
ERROR_INVALID_HANDLE
 Das Handle hClientHandle wurde in der Handle-Tabelle nicht gefunden.
ERROR_INVALID_PARAMETER
 Eine der folgenden Bedingungen ist aufgetreten:
  • hClientHandle ist NULL oder ungültig.
  • pInterfaceGuid ist NULL.
  • dwItems ist 0.
  • strProfileNames ist NULL.
  • Derselbe Profilname wird in strProfileNames mehrmals angezeigt.
  • pReserved ist nicht NULL.
ERROR_NOT_FOUND
 strProfileNames enthält den Namen eines Profils, das nicht im Profilspeicher vorhanden ist.
RPC_STATUS
 Verschiedene Fehlercodes.

Hinweise

Die WlanSetProfileList-Funktion legt die Voreinstellungsreihenfolge von WLAN-Profilen für eine bestimmte Drahtlose Schnittstelle fest.

Die Profile in der Liste müssen 1:1 mit den aktuellen Profilen übereinstimmen, die von der WlanGetProfileList-Funktion zurückgegeben werden. Die Position von Gruppenrichtlinienprofilen kann nicht geändert werden.

Alle Drahtlos-LAN-Funktionen erfordern eine Schnittstellen-GUID für die Drahtlose Schnittstelle, wenn Profilvorgänge ausgeführt werden. Wenn eine drahtlose Schnittstelle entfernt wird, wird ihr Zustand aus WLANSVC (Wireless LAN Service) gelöscht, und es sind keine Profilvorgänge möglich.

Die WlanSetProfileList-Funktion kann mit ERROR_INVALID_PARAMETER fehlschlagen, wenn die im pInterfaceGuid-Parameter angegebene drahtlose Schnittstelle aus dem System entfernt wurde (z. B. ein USB-Drahtlosadapter, der entfernt wurde).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wlanapi.h (einschließlich Wlanapi.h)
Bibliothek Wlanapi.lib
DLL Wlanapi.dll
Verteilbare Komponente Wlan-API für Windows XP mit SP2

Weitere Informationen

WlanGetProfile

WlanGetProfileList

WlanSetProfile