Funzione WlanSetProfilePosition (wlanapi.h)

Articolo
08/28/2023

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
ERROR_ACCESS_DENIED	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.
ERROR_INVALID_PARAMETER	hClientHandle è NULL o non valido, pInterfaceGuid è NULL, strProfileName è NULL o pReserved non è NULL.
ERROR_INVALID_HANDLE	L'handle hClientHandle non è stato trovato nella tabella handle.
RPC_STATUS	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

Vedi anche

Condividi tramite