Funzione InitializeSecurityDescriptor (securitybaseapi.h)

Articolo
03/15/2023

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