Compartir a través de

Función RtlGetGroupSecurityDescriptor (ntifs.h)

  • Artículo

La rutina RtlGetGroupSecurityDescriptor devuelve la información del grupo principal de 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) del 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 valor distinto de NULL .

Valor devuelto

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

Código devuelto Descripción
STATUS_UNKNOWN_REVISION
 El nivel de revisión del descriptor de seguridad no se conoce o no se admite. Se trata de un código de error.

Comentarios

Si el descriptor de seguridad al que apunta SecurityDescriptor contiene un grupo principal, RtlGetGroupSecurityDescriptor establece el puntero al que apunta Group en la dirección del SID del grupo del descriptor de seguridad y establece la variable a la que apunta GroupDefaulted en 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 de Microsoft Windows SDK.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Server 2003 SP1
Plataforma de destino Universal
Encabezado ntifs.h (incluya Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Consulte también

RtlGetOwnerSecurityDescriptor

RtlSetGroupSecurityDescriptor

SECURITY_DESCRIPTOR

SID