Función RtlSetOwnerSecurityDescriptor (ntifs.h)
El RtlSetOwnerSecurityDescriptor rutina 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.
NTSYSAPI NTSTATUS RtlSetOwnerSecurityDescriptor(
[in, out] PSECURITY_DESCRIPTOR SecurityDescriptor,
[in, optional] PSID Owner,
[in, optional] BOOLEAN OwnerDefaulted
);
[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 un identificador de seguridad (estructura de 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
Establézcalo 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.
rtlSetOwnerSecurityDescriptor puede devolver uno de los siguientes códigos de estado:
Código devuelto | Descripción |
---|---|
|
El propietario se estableció o restableció correctamente. |
|
Esta rutina no reconoce la versión del descriptor de seguridad dada. |
|
El descriptor de seguridad especificado no es un descriptor de seguridad absoluto válido. |
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.
Requisito | Valor |
---|---|
de la plataforma de destino de | Universal |
encabezado de | ntifs.h (incluya Ntifs.h) |
biblioteca de | NtosKrnl.lib |
DLL de | NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuario) |
irQL | < DISPATCH_LEVEL |