Funzione SetSecurityDescriptorControl (securitybaseapi.h)

Articolo
03/15/2023

La funzione SetSecurityDescriptorControl imposta i bit di controllo di un descrittore di sicurezza. La funzione può impostare solo i bit di controllo correlati all'ereditarietà automatica degli ACL. Per impostare gli altri bit di controllo di un descrittore di sicurezza, usare le funzioni, ad esempio SetSecurityDescriptorDacl, per modificare i componenti di un descrittore di sicurezza.

Sintassi

BOOL SetSecurityDescriptorControl(
  [in] PSECURITY_DESCRIPTOR        pSecurityDescriptor,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsOfInterest,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsToSet
);

Parametri

[in] pSecurityDescriptor

Puntatore a una struttura SECURITY_DESCRIPTOR il cui controllo e informazioni di revisione sono impostate.

[in] ControlBitsOfInterest

Maschera SECURITY_DESCRIPTOR_CONTROL che indica i bit di controllo da impostare.

[in] ControlBitsToSet

Maschera SECURITY_DESCRIPTOR_CONTROL che indica i nuovi valori per i bit di controllo specificati dalla maschera ControlBitsOfInterest .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione SetSecurityDescriptorControl specifica il bit o i bit di controllo da modificare e se i bit sono attiva o disattivati.

Esempio

Nell'esempio seguente viene contrassegnato l'elenco dati sul descrittore di sicurezza come protetto.

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, SE_DACL_PROTECTED );

L'esempio seguente contrassegna l'elenco dati come non protetto.

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, 0 );

Requisiti


Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	securitybaseapi.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll