RtlInitUTF8String function (wdm.h)

The RtlInitUTF8String function initializes a counted string of UTF-8 characters.

Syntax

NTSYSAPI VOID RtlInitUTF8String(
  PUTF8_STRING          DestinationString,
  __drv_aliasesMem PCSZ SourceString
);

Parameters

DestinationString

A pointer to UTF8_STRING (STRING) structure to be initialized.

SourceString

Optional pointer to a null-terminated character string. This string is used to initialize the counted string pointed to by DestinationString.

Return value

None

Remarks

The routine copies the SourceString pointer value to the Buffer member of the UTF8_STRING structure pointed to by DestinationString. The Length member of this structure is set to the length, in bytes, of the source string, excluding the terminating null. The MaximumLength member of the structure is set to the length, in bytes, of the source string, including the terminating null. If SourceString is NULL, Length and MaximumLength are both set to zero.

RtlInitUTF8String does not alter the source string pointed to by SourceString.

Requirements

Requirement Value
Minimum supported client Windows 10, version 2004
Header wdm.h

See also

RtlInitAnsiString