Expand Minimize

RtlInitEmptyUnicodeString macro

The RtlInitEmptyUnicodeString macro initializes an empty counted Unicode string.

Syntax


VOID RtlInitEmptyUnicodeString(
  [out] PUNICODE_STRING DestinationString,
  [in]  PWCHAR          Buffer,
  [in]  USHORT          BufferSize
);

Parameters

DestinationString [out]

Pointer to the UNICODE_STRING structure to be initialized.

Buffer [in]

Pointer to a caller-allocated buffer to be used to contain a WCHAR string.

BufferSize [in]

Length, in bytes, of the buffer that Buffer points to.

Return value

None.

Remarks

The members of the structure that the DestinationString parameters points to are initialized as follows.

MemberValue

Length

Zero

MaximumLength

BufferSize

Buffer

SourceString

 

To initialize a non-empty counted Unicode string, call RtlInitUnicodeString.

Requirements

Target platform

Desktop

Version

Available starting with Windows XP.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

IRQL

Any level

See also

RtlInitUnicodeString
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft