Funzione WlanSetProfilePosition (wlanapi.h)
La funzione WlanSetProfilePosition imposta la posizione di un singolo profilo specificato nell'elenco delle preferenze.
Sintassi
DWORD WlanSetProfilePosition(
[in] HANDLE hClientHandle,
[in] const GUID *pInterfaceGuid,
[in] LPCWSTR strProfileName,
[in] DWORD dwPosition,
PVOID pReserved
);
Parametri
[in] hClientHandle
Handle di sessione del client, ottenuto da una chiamata precedente alla funzione WlanOpenHandle .
[in] pInterfaceGuid
GUID dell'interfaccia.
[in] strProfileName
Nome del profilo. I nomi dei profili fanno distinzione tra maiuscole e minuscole. Questa stringa deve essere con terminazione NULL.
Windows XP con SP3 e API LAN wireless per Windows XP con SP2: Il nome specificato deve corrispondere al nome del profilo derivato automaticamente dall'SSID della rete. Per un profilo di rete dell'infrastruttura, è necessario specificare il valore SSID per il nome del profilo. Per un profilo di rete ad hoc, il nome specificato deve essere il SSID della rete ad hoc seguita da -adhoc.
[in] dwPosition
Indica la posizione nell'elenco delle preferenze in cui deve essere spostato il profilo. 0 (zero) corrisponde al primo profilo nell'elenco restituito dalla funzione WlanGetProfileList .
pReserved
Riservato per utilizzi futuri. Deve essere impostato su NULL.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene 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 la posizione del profilo.
Prima che WlanSetProfilePosition esegua un'operazione che modifica l'ordine relativo di tutti i profili utente nell'elenco dei profili o sposta un profilo all-utente in una posizione inferiore nell'elenco dei profili, WlanSetProfilePosition recupera l'elenco di controllo di accesso discrezionale (DACL) archiviato con l'oggetto wlan_secure_all_user_profiles_order . Se l'elenco DACL non contiene una voce di controllo di accesso (ACE) che concede WLAN_WRITE_ACCESS autorizzazione al token di accesso del thread chiamante, WlanSetProfilePosition restituisce ERROR_ACCESS_DENIED. |
|
hClientHandle è NULL o non valido, pInterfaceGuid è NULL, strProfileName è NULL o pReserved non è NULL. |
|
L'handle hClientHandle non è stato trovato nella tabella handle. |
|
Vari codici di errore. |
Commenti
La posizione dei profili criteri di gruppo non può essere modificata.
Per impostazione predefinita, solo un utente connesso come membro del gruppo Administrators può modificare la posizione di un profilo utente completo. Chiamare WlanGetSecuritySettings per determinare i diritti utente effettivi necessari per modificare la posizione di un profilo all-utente.
Per impostare la posizione del profilo nella riga di comando, usare il comando netsh wlan set profileorder . Per altre informazioni, vedere Netsh Commands for Wireless Local Area Network (wlan).For more information, see Netsh Commands for Wireless Local Area Network (wlan).
Windows XP con SP3 e API LAN wireless per Windows XP con SP2: I profili ad hoc vengono visualizzati dopo i profili di infrastruttura nell'elenco dei profili. Se si tenta di posizionare un profilo ad hoc prima di un profilo di infrastruttura utilizzando WlanSetProfilePosition, la chiamata WlanSetProfilePosition avrà esito positivo, ma il servizio Wireless Zero Configuration riordina l'elenco dei profili in modo che il profilo ad hoc venga posizionato dopo tutti i profili di rete dell'infrastruttura.
I profili guest, i profili con autenticazione WPS (Wireless Provisioning Service) e i profili con autenticazione Wi-Fi Protected Access-None (WPA-None) non sono supportati. Qualsiasi profilo visualizzato nell'elenco dei profili preferito ha una posizione fissa nell'elenco dei profili. Ciò significa che la sua posizione non può essere modificata utilizzando WlanSetProfilePosition e che la sua posizione non è influenzata dalle modifiche di posizione di altri profili.
Tutte le funzioni LAN wireless richiedono un GUID di interfaccia per l'interfaccia wireless durante l'esecuzione di operazioni del profilo. Quando viene rimossa un'interfaccia wireless, il relativo stato viene cancellato dal servizio LAN wireless (WLANSVC) e non è possibile eseguire alcuna operazione di profilo.
La funzione WlanSetProfilePosition può avere esito negativo con ERROR_INVALID_PARAMETER se l'interfaccia wireless specificata nel parametro pInterfaceGuid è stata rimossa dal sistema (ad esempio una scheda wireless USB rimossa).
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 |