Función SetSecurityDescriptorOwner (securitybaseapi.h)

Artículo
03/15/2023

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, es 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