Función RtlCreateSecurityDescriptorRelative (ntifs.h)

Artículo
02/26/2024

La rutina RtlCreateSecurityDescriptorRelative inicializa un nuevo descriptor de seguridad en formato relativo a sí mismo. A cambio, el descriptor de seguridad se inicializa sin ACL del sistema (SACL), sin ACL discrecional (DACL), sin propietario, sin grupo principal y todas las marcas de control establecidas en cero.

Sintaxis

NTSYSAPI NTSTATUS RtlCreateSecurityDescriptorRelative(
  [out] PISECURITY_DESCRIPTOR_RELATIVE SecurityDescriptor,
  [in]  ULONG                          Revision
);

Parámetros

[out] SecurityDescriptor

Puntero a un búfer asignado por el autor de la llamada, que debe ser al menos sizeof(SECURITY_DESCRIPTOR_RELATIVE), para recibir el descriptor de seguridad inicializado.

[in] Revision

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

Valor devuelto

RtlCreateSecurityDescriptorRelative puede devolver una de las siguientes opciones:

Código devuelto	Descripción
STATUS_SUCCESS	La llamada se ha realizado correctamente.
STATUS_UNKNOWN_REVISION	La revisión especificada no se conoce o no se admite.

Comentarios

En efecto, una llamada correcta a esta rutina inicializa un descriptor de seguridad sin restricciones de seguridad.

Para obtener más información sobre la seguridad y el control de acceso, consulte Modelo de seguridad de Windows para desarrolladores de controladores y la documentación sobre estos temas en Windows SDK.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000
Plataforma de destino	Escritorio
Encabezado	ntifs.h (incluya Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL