Condividi tramite


Funzione InitializeSecurityDescriptor (securitybaseapi.h)

La funzione InitializeSecurityDescriptor inizializza un nuovo descrittore di sicurezza.

Sintassi

BOOL InitializeSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]  DWORD                dwRevision
);

Parametri

[out] pSecurityDescriptor

Puntatore a una struttura SECURITY_DESCRIPTOR inizializzata dalla funzione.

[in] dwRevision

Livello di revisione da assegnare al descrittore di sicurezza. Questo parametro deve essere SECURITY_DESCRIPTOR_REVISION.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione InitializeSecurityDescriptor inizializza un descrittore di sicurezza in formato assoluto anziché in formato auto-relativo .

La funzione InitializeSecurityDescriptor inizializza un descrittore di sicurezza per non avere alcun elenco di controllo di accesso di sistema (SACL), nessun elenco di controllo di accesso discrezionale (DACL), nessun proprietario, nessun gruppo primario e tutti i flag di controllo impostati su FALSE (NULL). Pertanto, ad eccezione del livello di revisione, è vuoto.

Esempio

Per un esempio che usa questa funzione, vedere Creazione di un descrittore di sicurezza per un nuovo oggetto.

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

Vedi anche

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Controllo di accesso di basso livello

Funzioni di Controllo di accesso di basso livello

SECURITY_DESCRIPTOR

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner

SetSecurityDescriptorSacl