Funzione WlanSetProfileList (wlanapi.h)
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 |
|---|---|
|
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. |
|
L'handle hClientHandle non è stato trovato nella tabella handle. |
|
Si è verificata una delle seguenti condizioni:
|
|
strProfileNames contiene il nome di un profilo non presente nell'archivio profili. |
|
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 |