Função RtlInitializeSid (ntifs.h)
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 |
|---|---|
|
O SID foi inicializado com êxito. |
|
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
| 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 |