Compartir a través de


Función RtlSetOwnerSecurityDescriptor (ntifs.h)

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

Consulte también

RtlCreateSecurityDescriptor

RtlCreateSecurityDescriptorRelative

RtlLengthSecurityDescriptor

RtlSetDaclSecurityDescriptor

RtlValidSecurityDescriptor

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SID

SeAssignSecurity