Função RtlCopyUnicodeString (wdm.h)

A rotina RtlCopyUnicodeString copia uma cadeia de caracteres de origem para uma cadeia de caracteres de destino.

Sintaxe

NTSYSAPI VOID RtlCopyUnicodeString(
  [in, out]      PUNICODE_STRING  DestinationString,
  [in, optional] PCUNICODE_STRING SourceString
);

Parâmetros

[in, out] DestinationString

Um ponteiro para o buffer de cadeia de caracteres de destino. Esse parâmetro aponta para uma estrutura UNICODE_STRING .

[in, optional] SourceString

Um ponteiro para o buffer de cadeia de caracteres de origem. Esse parâmetro aponta para uma estrutura UNICODE_STRING .

Retornar valor

Nenhum

Comentários

Se SourceString for NULL, essa rotina definirá o campo Comprimento da estrutura apontada por DestinationString como zero.

Essa rotina não modifica os campos MaximumLength e Buffer da estrutura apontada por DestinationString.

O número de bytes copiados da cadeia de caracteres de origem é o comprimento da cadeia de caracteres de origem (especificado pelo membro Length da estrutura apontada por SourceString) ou o comprimento máximo da cadeia de caracteres de destino (especificado pelo membro MaximumLength da estrutura apontada por DestinationString), o que for menor.

O chamador deve inicializar corretamente todos os membros da estrutura apontada por DestinationString antes de chamar RtlCopyUnicodeString. Falha ao inicializar o membro Length ou MaximumLength antes de chamar essa rotina pode causar um estouro de buffer.

Os buffers DestinationString e SourceString deverão ser residentes se o chamador estiver em execução em IRQL >= DISPATCH_LEVEL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 2000.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário)
IRQL	Qualquer nível (consulte a seção Comentários)

Confira também

RtlCopyString

UNICODE_STRING