Freigeben über


RtlAnsiStringToUnicodeSize-Makro (wdm.h)

Die RtlAnsiStringToUnicodeSize-Routine gibt die Anzahl der Bytes zurück, die erforderlich sind, um eine in eine Unicode-Zeichenfolge konvertierte ANSI-Zeichenfolge zu enthalten.

Syntax

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

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

Parameter

[in] STRING

Zeiger auf einen Puffer, der die ANSI-Zeichenfolge enthält.

Rückgabewert

Keine

Bemerkungen

RtlAnsiStringToUnicodeSize gibt einen ULONG-Wert zurück, der die Anzahl der Bytes enthält, die erforderlich sind, um eine in eine Unicode-Zeichenfolge konvertierte ANSI-Zeichenfolge zu enthalten.

Das Umwandeln des Rückgabewerts der RtlAnsiStringToUnicodeSize-Routine in USHORT kann zu Einem Datenverlust führen. Um potenzielle Probleme zu vermeiden, sollten Aufrufer dieser Routine den Rückgabewert auf arithmetischen Überlauf testen. Beachten Sie, dass RtlAnsiStringToUnicodeSize für den nachfolgenden NULL-Wert verwendet.

Aufrufer von RtlAnsiStringToUnicodeSize müssen unter IRQL = PASSIVE_LEVEL ausgeführt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 2000.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Weitere Informationen

RtlAnsiStringToUnicodeString

RtlxAnsiStringToUnicodeSize