Función RtlGetGroupSecurityDescriptor (ntifs.h)

El rtlGetGroupSecurityDescriptor rutina devuelve la información del grupo principal para un descriptor de seguridad determinado.

Sintaxis

NTSYSAPI NTSTATUS RtlGetGroupSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PSID                 *Group,
  [out] PBOOLEAN             GroupDefaulted
);

Parámetros

[in] SecurityDescriptor

Puntero al descriptor de seguridad cuya información de grupo principal se va a devolver.

[out] Group

Puntero a una variable que recibe un puntero al identificador de seguridad (SID) para el grupo principal. Si el descriptor de seguridad no contiene un grupo principal, *Group recibe NULL.

[out] GroupDefaulted

Puntero a una variable booleana que recibe el valor de la marca SE_GROUP_DEFAULTED en la estructura SECURITY_DESCRIPTOR_CONTROL del descriptor de seguridad. Este valor solo es válido si *Group recibe un valornull que no es.

Valor devuelto

rtlGetGroupSecurityDescriptor devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como el siguiente:

Observaciones

Si el descriptor de seguridad al que apunta SecurityDescriptor contiene un grupo principal, RtlGetGroupSecurityDescriptor establece el puntero al que apunta Group a la dirección del SID de grupo del descriptor de seguridad y establece la variable a la que apunta GroupDefaulted a un valor válido.

Si el descriptor de seguridad al que apunta securityDescriptor no contiene un grupo principal, RtlGetGroupSecurityDescriptor establece el puntero al que apunta group en NULL y omite el parámetro de salida restante, GroupDefaulted.

Para establecer la información del grupo principal para un descriptor de seguridad, use RtlSetGroupSecurityDescriptor.

Para recuperar la información del propietario de un descriptor de seguridad, use RtlGetOwnerSecurityDescriptor.

Para obtener más información sobre la seguridad y el control de acceso, consulte la documentación del SDK de Microsoft Windows.

Requisitos

Consulte también

RtlGetOwnerSecurityDescriptor

RtlSetGroupSecurityDescriptor

SECURITY_DESCRIPTOR

de SID