Compartilhar via


Função RtlCopyString (ntddk.h)

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

Sintaxe

NTSYSAPI VOID RtlCopyString(
  [out]          PSTRING      DestinationString,
  [in, optional] const STRING *SourceString
);

Parâmetros

[out] DestinationString

Um ponteiro para o buffer de cadeia de caracteres de destino.

[in, optional] SourceString

Um ponteiro para o buffer de cadeia de caracteres de origem.

Valor de retorno

Nenhum

Observações

O DestinationString Length será definido como zero se nenhuma cadeia de caracteres de origem for fornecida. Os MaximumLength e membros do buffer membros do DestinationString não são modificados por essa rotina.

O número de bytes copiados do SourceString é o comprimento de SourceString ou o comprimento máximo de DestinationString, o que for menor.

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível a partir do Windows 2000.
da Plataforma de Destino Universal
cabeçalho ntddk.h (inclua Ntddk.h, Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL Qualquer nível (seção Ver Comentários)

Consulte também

rtlCopyUnicodeString