RtlAnsiStringToUnicodeSize macro (wdm.h)

The RtlAnsiStringToUnicodeSize routine returns the number of bytes required to hold an ANSI string converted into a Unicode string.

Syntax

//
//  NTSYSAPI
//  ULONG
//  NTAPI
//  RtlAnsiStringToUnicodeSize(
//      PANSI_STRING AnsiString
//      );
//

#define RtlAnsiStringToUnicodeSize(STRING) (                 \
    RtlxAnsiStringToUnicodeSize(STRING)                      \
)

Parameters

[in] STRING

Pointer to a buffer containing the ANSI string.

Return value

None

Remarks

RtlAnsiStringToUnicodeSize returns a ULONG value containing the number of bytes required to hold an ANSI string converted into a Unicode string.

Casting the return value of the RtlAnsiStringToUnicodeSize routine to USHORT might cause a loss of data. To avoid potential problems, callers of this routine should test the return value for arithmetic overflow. Note that RtlAnsiStringToUnicodeSize accounts for the trailing NULL.

Callers of RtlAnsiStringToUnicodeSize must be running at IRQL = PASSIVE_LEVEL.

Requirements

See also

RtlAnsiStringToUnicodeString

RtlxAnsiStringToUnicodeSize