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 por chamador a ser inicializada.
[in] IdentifierAuthority
Ponteiro para uma estrutura SID_IDENTIFIER_AUTHORITY a ser definida na estrutura sid.
[in] SubAuthorityCount
Número de sub-coautorias a serem definidas no SID. Os valores de subautoridade devem ser definidos separadamente, conforme descrito na seção Comentários a seguir.
Valor de retorno
RtlInitializeSid retorna um dos seguintes:
| Código de retorno | Descrição |
|---|---|
|
O SID foi inicializado com êxito. |
|
O valor de SubAuthorityCount especificado é inválido. |
Observações
Embora RtlInitializeSid define o número de sub-propriedades para o SID, ele não define os valores de sub-propriedade. 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 |
|---|---|
| de cliente com suporte mínimo | Windows 2000 |
| da Plataforma de Destino | Universal |
| cabeçalho | ntifs.h (inclua Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário) |
| IRQL | < DISPATCH_LEVEL |