Share via

Função RtlInitializeSid (ntifs.h)

  • Artigo

A rotina RtlInitializeSid inicializa uma estrutura sid (identificador de segurança).

Sintaxe

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

Parâmetros

[out] Sid

Ponteiro para uma estrutura sid alocada pelo chamador a ser inicializada.

[in] IdentifierAuthority

Ponteiro para uma estrutura SID_IDENTIFIER_AUTHORITY a ser definida na estrutura SID.

[in] SubAuthorityCount

Número de subautoridades a serem definidas no SID. Os valores de subautoridade devem ser definidos separadamente, conforme descrito na seção Comentários a seguir.

Retornar valor

RtlInitializeSid retorna um dos seguintes:

Código de retorno Descrição
STATUS_SUCCESS
 O SID foi inicializado com êxito.
STATUS_INVALID_PARAMETER
 O valor de SubAuthorityCount especificado é inválido.

Comentários

Embora RtlInitializeSid defina o número de subautoridades para o SID, ele não define os valores de subautoridade. Isso deve ser feito separadamente chamando RtlSubAuthoritySid.

Para obter mais informações sobre segurança e controle de acesso, consulte Modelo de segurança do Windows para desenvolvedores de driver e a documentação sobre esses tópicos no SDK do Windows.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário)
IRQL < DISPATCH_LEVEL

Confira também

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY