Funzione WlanSetSecuritySettings (wlanapi.h)

Articolo
08/28/2023

La funzione WlanGetProfileList imposta le impostazioni di sicurezza per un oggetto configurabile.

Sintassi

DWORD WlanSetSecuritySettings(
  [in] HANDLE                hClientHandle,
  [in] WLAN_SECURABLE_OBJECT SecurableObject,
  [in] LPCWSTR               strModifiedSDDL
);

Parametri

[in] hClientHandle

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

[in] SecurableObject

Valore WLAN_SECURABLE_OBJECT che specifica l'oggetto a cui verranno applicate le impostazioni di sicurezza.

[in] strModifiedSDDL

Stringa del descrittore di sicurezza che specifica le nuove impostazioni di sicurezza per l'oggetto. Questa stringa deve essere con terminazione NULL. Per altre informazioni, vedere la sezione Osservazioni.

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_INVALID_PARAMETER	Un parametro non è corretto. Questo errore viene restituito se si verifica una delle condizioni seguenti: hClientHandle è NULL. strModifiedSDDL è NULL. SecurableObject è impostato su un valore maggiore o uguale a WLAN_SECURABLE_OBJECT_COUNT (12).
ERROR_INVALID_HANDLE	Handle non valido. Questo errore viene restituito se l'handle specificato nel parametro hClientHandle non è stato trovato nella tabella handle.
ERROR_ACCESS_DENIED	Il chiamante non dispone di autorizzazioni sufficienti.
ERROR_NOT_SUPPORTED	Questa funzione è stata chiamata da una piattaforma non supportata. Questo valore verrà restituito se questa funzione è stata chiamata da un'API Windows XP con SP3 o LAN wireless per Windows XP con il client SP2.

Commenti

Una chiamata riuscita alla funzione WlanSetSecuritySettings sostituisce le autorizzazioni predefinite associate a un oggetto . Per altre informazioni sulle autorizzazioni predefinite, vedere Autorizzazioni API Wi-Fi native.

Di seguito viene descritta la procedura per la creazione di un oggetto descrittore di sicurezza e l'analisi come stringa.

Chiamare InitializeSecurityDescriptor per creare un descrittore di sicurezza in memoria.
Chiamare SetSecurityDescriptorOwner per impostare le informazioni sul proprietario per il descrittore di sicurezza.
Chiamare InitializeAcl per creare un elenco di controllo di accesso discrezionale (DACL) in memoria.
Chiamare AddAccessAllowedAce o AddAccessDeniedAce per aggiungere voci di controllo di accesso (ACL) all'elenco DACL. Impostare il parametro AccessMask su una delle combinazioni OR bit per bit seguenti in base alle esigenze:
- WLAN_READ_ACCESS
- WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS
- WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS | WLAN_WRITE_ACCESS
Chiamare SetSecurityDescriptorDacl per aggiungere l'elenco DACL al descrittore di sicurezza.
Chiamare ConvertSecurityDescriptorToStringSecurityDescriptor per convertire il descrittore in stringa.

La stringa restituita da ConvertSecurityDescriptorToStringSecurityDescriptor può quindi essere usata come valore del parametro strModifiedSDDL quando si chiama WlanSetSecuritySettings.

Requisiti


Client minimo supportato	Windows Vista [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

Vedi anche

Autorizzazioni API Wi-Fi native

WlanGetSecuritySettings

Share via