Función RtlSetOwnerSecurityDescriptor (ntifs.h)

Artículo
02/26/2024

La rutina RtlSetOwnerSecurityDescriptor establece la información de propietario de un descriptor de seguridad de formato absoluto. Reemplaza cualquier información de propietario que ya esté presente en el descriptor de seguridad.

Sintaxis

NTSYSAPI NTSTATUS RtlSetOwnerSecurityDescriptor(
  [in, out]      PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in, optional] PSID                 Owner,
  [in, optional] BOOLEAN              OwnerDefaulted
);

Parámetros

[in, out] SecurityDescriptor

Puntero a la estructura SECURITY_DESCRIPTOR cuyo propietario se va a establecer. RtlSetOwnerSecurityDescriptor reemplaza a cualquier propietario existente por el nuevo propietario.

[in, optional] Owner

Puntero a una estructura de identificador de seguridad (SID) para el nuevo propietario principal del descriptor de seguridad. Este puntero, no la propia estructura de SID, se copia en el descriptor de seguridad. Si este parámetro es NULL, RtlSetOwnerSecurityDescriptor borra la información del propietario del descriptor de seguridad. Esto marca el descriptor de seguridad como sin propietario.

[in, optional] OwnerDefaulted

Se establece en TRUE si la información del propietario se deriva de un mecanismo predeterminado. Si este valor es TRUE, es información predeterminada. RtlSetOwnerSecurityDescriptor establece la marca de SE_OWNER_DEFAULTED en el campo SECURITY_DESCRIPTOR_CONTROL del descriptor de seguridad. Si este parámetro es FALSE, se borra la marca SE_OWNER_DEFAULTED.

Valor devuelto

RtlSetOwnerSecurityDescriptor puede devolver uno de los siguientes códigos de estado:

Código devuelto	Descripción
STATUS_SUCCESS	El propietario se estableció o restableció correctamente.
STATUS_UNKNOWN_REVISION	Esta rutina no reconoce la versión del descriptor de seguridad dado.
STATUS_INVALID_SECURITY_DESCR	El descriptor de seguridad especificado no es un descriptor de seguridad absoluto válido.

Comentarios

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
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuario)
IRQL	< DISPATCH_LEVEL