Compartir a través de


Función SetSecurityDescriptorGroup (securitybaseapi.h)

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

Consulte también

GetSecurityDescriptorGroup

InitializeSecurityDescriptor

Access Control de bajo nivel

Funciones de Access Control de bajo nivel

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SID

SetSecurityDescriptorDacl

SetSecurityDescriptorOwner

SetSecurityDescriptorSacl