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

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:
© 2014 Microsoft