Función SetSecurityDescriptorGroup (securitybaseapi.h)

Artículo
03/01/2024

La función SetSecurityDescriptorGroup establece la información del grupo principal de un descriptor de seguridad de formato absoluto, reemplazando cualquier información de grupo principal que ya esté presente en el descriptor de seguridad.

Sintaxis

BOOL SetSecurityDescriptorGroup(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pGroup,
  [in]           BOOL                 bGroupDefaulted
);

Parámetros

[in, out] pSecurityDescriptor

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

[in, optional] pGroup

Puntero a una estructura de SID para el nuevo grupo 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 grupo principal del descriptor de seguridad. Esto marca el descriptor de seguridad como sin grupo principal.

[in] bGroupDefaulted

Indica si la información del grupo principal se ha derivado de un mecanismo predeterminado. Si este valor es TRUE, es información predeterminada y la función almacena este valor como la marca SE_GROUP_DEFAULTED en la estructura de SECURITY_DESCRIPTOR_CONTROL . Si este parámetro es cero, se borra la marca SE_GROUP_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

Requisito	Value
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