Compartir a través de

Función RtlInitializeSid (ntifs.h)

  • Artículo

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