Función SetSecurityDescriptorOwner (securitybaseapi.h)

La función SetSecurityDescriptorOwner 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

BOOL SetSecurityDescriptorOwner(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pOwner,
  [in]           BOOL                 bOwnerDefaulted
);

Parámetros

[in, out] pSecurityDescriptor

Puntero a la estructura SECURITY_DESCRIPTOR cuyo propietario está establecido por esta función. La función reemplaza a cualquier propietario existente por el nuevo propietario.

[in, optional] pOwner

Puntero a una estructura de SID para el nuevo propietario principal del descriptor de seguridad. El descriptor de seguridad hace referencia a la estructura del SID , no se copia en . Si este parámetro es NULL, la función borra la información del propietario del descriptor de seguridad. Esto marca el descriptor de seguridad como sin propietario.

[in] bOwnerDefaulted

Indica si la información del propietario se deriva de un mecanismo predeterminado. Si este valor es TRUE, se trata de información predeterminada. La función almacena este valor como la marca SE_OWNER_DEFAULTED en la estructura SECURITY_DESCRIPTOR_CONTROL . Si este parámetro es cero, se borra la marca SE_OWNER_DEFAULTED.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

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

Consulte también

GetSecurityDescriptorOwner

InitializeSecurityDescriptor

IsValidSecurityDescriptor

Access Control de bajo nivel

Funciones de Access Control de bajo nivel

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SID

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorSacl