Función RtlInitializeSid (ntifs.h)

La rutina RtlInitializeSid inicializa una estructura de identificador de seguridad (SID).

Sintaxis

NTSYSAPI NTSTATUS RtlInitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY IdentifierAuthority,
  [in]  UCHAR                     SubAuthorityCount
);

Parámetros

[out] Sid

Puntero a una estructura de SID asignada por el autor de la llamada que se va a inicializar.

[in] IdentifierAuthority

Puntero a una estructura de SID_IDENTIFIER_AUTHORITY que se va a establecer en la estructura del SID.

[in] SubAuthorityCount

Número de subauthoridades que se van a establecer en el SID. Los valores de subauthority deben establecerse por separado, como se describe en la sección Comentarios siguiente.

Valor devuelto

RtlInitializeSid devuelve una de las siguientes opciones:

Código devuelto	Descripción
STATUS_SUCCESS	El SID se inicializó correctamente.
STATUS_INVALID_PARAMETER	El valor de SubAuthorityCount especificado no es válido.

Comentarios

Aunque RtlInitializeSid establece el número de subauthoridades para el SID, no establece los valores de subauthority. Esto se debe hacer por separado llamando a RtlSubAuthoritySid.

Para obtener más información sobre la seguridad y el control de acceso, consulte Modelo de seguridad de Windows para desarrolladores de controladores y la documentación sobre estos temas en Windows SDK.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuario)
IRQL	< DISPATCH_LEVEL

Consulte también

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY