Compartilhar via


Função RtlCopySid (ntifs.h)

A rotina RtlCopySid copia o valor de um SID (identificador de segurança) para um buffer.

Sintaxe

NTSYSAPI NTSTATUS RtlCopySid(
  [in] ULONG DestinationSidLength,
  [in] PSID  DestinationSid,
  [in] PSID  SourceSid
);

Parâmetros

[in] DestinationSidLength

Comprimento, em bytes, do buffer para receber a cópia do SID.

[in] DestinationSid

Ponteiro para um buffer alocado por chamador para receber uma cópia da estrutura sid de origem. O buffer deve ter pelo menos tamanho de(SID),

[in] SourceSid

Ponteiro para a estrutura sid de origem a ser copiada.

Valor de retorno

RtlCopySid retornará STATUS_SUCCESS se o SID tiver sido copiado com êxito. Caso contrário, ele retornará um valor NTSTATUS, como um dos seguintes:

Código de retorno Descrição
STATUS_BUFFER_TOO_SMALL
O buffer DestinationSid não era grande o suficiente para receber uma cópia do SID.

Observações

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
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 <= APC_LEVEL

Consulte também

rtlEqualPrefixSid

rtlEqualSid

rtlLengthSid

rtlValidSid

SID