RtlUnicodeToMultiByteSize-Funktion (winternl.h)

Artikel
01/27/2024

Bestimmt, wie viele Bytes benötigt werden, um eine Unicode-Zeichenfolge als ANSI-Zeichenfolge darzustellen.

Syntax

NTSTATUS RtlUnicodeToMultiByteSize(
  [out] PULONG BytesInMultiByteString,
  [in]  PWCH   UnicodeString,
  [in]  ULONG  BytesInUnicodeString
);

Parameter

[out] BytesInMultiByteString

Gibt die Anzahl der Bytes für die ANSI-Entsprechung der Unicode-Zeichenfolge zurück, auf die von UnicodeString verwiesen wird. Diese Zahl enthält nicht das beendende NULL-Zeichen .

[in] UnicodeString

Die Unicode-Quellzeichenfolge, für die die ANSI-Länge berechnet wird.

[in] BytesInUnicodeString

Die Anzahl der Bytes in der Zeichenfolge, auf die von UnicodeString verwiesen wird.

Rückgabewert

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Anzahl war erfolgreich. Die verschiedenen NTSTATUS-Werte werden in NTSTATUS definiert. H, das mit dem Windows DDK verteilt wird.

Hinweise

Es wird empfohlen, WideCharToMultiByte anstelle von RtlUnicodeToMultiByteSize zu verwenden. Wenn der cbMultiByte-Parameter auf 0 festgelegt ist, gibt die WideCharToMultiByte-Funktion die Anzahl der Bytes zurück, die für den Puffer erforderlich sind.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winternl.h
Bibliothek	ntdll.lib
DLL	ntdll.dll

Freigeben über