Función InitializeSecurityDescriptor (securitybaseapi.h)

Artículo
03/15/2023

La función InitializeSecurityDescriptor inicializa un nuevo descriptor de seguridad.

Sintaxis

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

Parámetros

[out] pSecurityDescriptor

Puntero a una estructura SECURITY_DESCRIPTOR que inicializa la función.

[in] dwRevision

Nivel de revisión que se va a asignar al descriptor de seguridad. Este parámetro debe ser SECURITY_DESCRIPTOR_REVISION.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero.

Si se produce un error en la función, devuelve cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función InitializeSecurityDescriptor inicializa un descriptor de seguridad en formato absoluto , en lugar de un formato auto relativo .

La función InitializeSecurityDescriptor inicializa un descriptor de seguridad para que no tenga ninguna lista de control de acceso del sistema (SACL), ninguna lista de control de acceso discrecional (DACL), ningún propietario, ningún grupo principal y todas las marcas de control establecidas en FALSE (NULL). Por lo tanto, excepto por su nivel de revisión, está vacío.

Ejemplos

Para obtener un ejemplo que usa esta función, vea Creating a Security Descriptor for a New Object.

Requisitos


Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	securitybaseapi.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll