RtlCopyString function (ntddk.h)

The RtlCopyString routine copies a source string to a destination string.

Syntax

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

Parameters

[out] DestinationString

A pointer to the destination string buffer.

[in, optional] SourceString

A pointer to the source string buffer.

Return value

None

Remarks

The DestinationString Length is set to zero if no source string is supplied. The MaximumLength and Buffer members of the DestinationString are not modified by this routine.

The number of bytes copied from the SourceString is either the length of SourceString or the maximum length of DestinationString, whichever is smaller.

The DestinationString and SourceString buffers must be resident if the caller is running at IRQL >= DISPATCH_LEVEL.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 2000.
Target Platform Universal
Header ntddk.h (include Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Any level (See Remarks section)

See also

RtlCopyUnicodeString