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 pelo chamador para receber uma cópia da estrutura sid de origem. O buffer deve ser pelo menos sizeof(SID),

[in] SourceSid

Ponteiro para a estrutura sid de origem a ser copiada.

Retornar valor

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.

Comentários

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

Confira também

RtlEqualPrefixSid

RtlEqualSid

RtlLengthSid

RtlValidSid

SID