Función GetSecurityDescriptorGroup (securitybaseapi.h)
La función GetSecurityDescriptorGroup recupera la información del grupo principal de un descriptor de seguridad.
Sintaxis
BOOL GetSecurityDescriptorGroup(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[out] PSID *pGroup,
[out] LPBOOL lpbGroupDefaulted
);
Parámetros
[in] pSecurityDescriptor
Puntero a una estructura de SECURITY_DESCRIPTOR cuya información de grupo principal recupera la función.
[out] pGroup
Puntero a un puntero a un identificador de seguridad (SID) que identifica el grupo principal cuando la función devuelve. Si el descriptor de seguridad no contiene un grupo principal, la función establece el puntero al que apunta pGroup en NULL y omite el parámetro de salida restante, lpbGroupDefaulted. Si el descriptor de seguridad contiene un grupo principal, la función establece el puntero al que apunta pGroup en la dirección del SID del grupo del descriptor de seguridad y proporciona un valor válido para la variable a la que apunta lpbGroupDefaulted.
[out] lpbGroupDefaulted
Puntero a una marca que se establece en el valor de la marca SE_GROUP_DEFAULTED en la estructura SECURITY_DESCRIPTOR_CONTROL cuando la función devuelve. Si el valor almacenado en la variable a la que apunta el parámetro pGroup es NULL, no se establece ningún valor.
Valor devuelto
Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero.
Si se produce un error en la función, devuelve 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 |