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 |