Funzione WlanSetProfileList (wlanapi.h)

Articolo
08/28/2023

La funzione WlanSetProfileList imposta l'ordine di preferenza dei profili per una determinata interfaccia.

Sintassi

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

Parametri

[in] hClientHandle

Handle di sessione del client ottenuto da una chiamata precedente alla funzione WlanOpenHandle .

[in] pInterfaceGuid

GUID dell'interfaccia.

[in] dwItems

Numero di profili nel parametro strProfileNames .

[in] strProfileNames

Nomi dei profili nell'ordine desiderato. I nomi dei profili sono distinzione tra maiuscole e minuscole. Questa stringa deve essere terminata con null.

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: I nomi specificati devono corrispondere ai nomi dei profili derivati automaticamente dall'SSID della rete. Per i profili di rete dell'infrastruttura, è necessario specificare SSID per il nome del profilo. Per i profili di rete ad hoc, il nome specificato deve essere SSID della rete ad hoc seguita da -adhoc.

pReserved

Riservato per utilizzi futuri. Deve essere impostato su NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici restituiti seguenti.

Codice restituito	Descrizione
ERROR_ACCESS_DENIED	Il chiamante non dispone di autorizzazioni sufficienti per modificare l'elenco dei profili. Prima che WlanSetProfileList esegua un'operazione che modifica l'ordine relativo di tutti i profili utente nell'elenco dei profili o sposta un profilo utente in una posizione inferiore nell'elenco dei profili, WlanSetProfileList recupera l'elenco di controllo di accesso discrezionale archiviato con l'oggetto wlan_secure_all_user_profiles_order . Se l'elenco dati non contiene una voce di controllo di accesso (ACE) che concede l'autorizzazione WLAN_WRITE_ACCESS al token di accesso del thread chiamante, WlanSetProfileList restituisce ERROR_ACCESS_DENIED.
ERROR_INVALID_HANDLE	L'handle hClientHandle non è stato trovato nella tabella handle.
ERROR_INVALID_PARAMETER	Si è verificata una delle seguenti condizioni: hClientHandle è NULL o non valido. pInterfaceGuid è NULL. dwItems è 0. strProfileNames è NULL. Lo stesso nome del profilo viene visualizzato più volte in strProfileNames. pReserved non è NULL.
ERROR_NOT_FOUND	strProfileNames contiene il nome di un profilo non presente nell'archivio profili.
RPC_STATUS	Vari codici di errore.

Commenti

La funzione WlanSetProfileList imposta l'ordine di preferenza dei profili LAN wireless per una determinata interfaccia wireless.

I profili nell'elenco devono essere una corrispondenza uno-a-uno con i profili correnti restituiti dalla funzione WlanGetProfileList . Impossibile modificare la posizione dei profili dei criteri di gruppo.

Tutte le funzioni LAN wireless richiedono un GUID di interfaccia per l'interfaccia wireless durante l'esecuzione delle operazioni del profilo. Quando un'interfaccia wireless viene rimossa, lo stato viene cancellato dal servizio LAN wireless (WLANSVC) e non sono possibili operazioni di profilo.

La funzione WlanSetProfileList può non riuscire con ERROR_INVALID_PARAMETER se l'interfaccia wireless specificata nel parametro pInterfaceGuid è stata rimossa dal sistema (un adattatore wireless USB rimosso, ad esempio).

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wlanapi.h (include Wlanapi.h)
Libreria	Wlanapi.lib
DLL	Wlanapi.dll
Componente ridistribuibile	API LAN wireless per Windows XP con SP2

Vedi anche

WlanGetProfile

WlanGetProfileList

WlanSetProfile

Condividi tramite