Funzione GetSecurityDescriptorLength (securitybaseapi.h)

Articolo
03/13/2024

La funzione GetSecurityDescriptorLength restituisce la lunghezza, in byte, di un descrittore di sicurezza strutturalemente valido. La lunghezza include la lunghezza di tutte le strutture associate.

Sintassi

DWORD GetSecurityDescriptorLength(
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parametri

[in] pSecurityDescriptor

Puntatore alla struttura SECURITY_DESCRIPTOR la cui lunghezza restituisce la funzione. Si presuppone che il puntatore sia valido.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce la lunghezza, in byte, della struttura SECURITY_DESCRIPTOR .

Se la struttura SECURITY_DESCRIPTOR non è valida, il valore restituito non è definito.

Commenti

La lunghezza minima di un descrittore di sicurezza è SECURITY_DESCRIPTOR_MIN_LENGTH. Un descrittore di sicurezza di questa lunghezza non ha identificatori di sicurezza associati (SID) o elenchi di controllo di accesso (ACL).

Requisiti

Requisito	Valore
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