Macro RtlAnsiStringToUnicodeSize (wdm.h)

  • Article

La routine RtlAnsiStringToUnicodeSize retourne le nombre d’octets requis pour contenir une chaîne ANSI convertie en chaîne Unicode.

Syntaxe

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

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

Paramètres

[in] STRING

Pointeur vers une mémoire tampon contenant la chaîne ANSI.

Valeur de retour

None

Remarques

RtlAnsiStringToUnicodeSize retourne une valeur ULONG contenant le nombre d’octets requis pour contenir une chaîne ANSI convertie en chaîne Unicode.

Le cast de la valeur de retour de la routine RtlAnsiStringToUnicodeSize en USHORT peut entraîner une perte de données. Pour éviter les problèmes potentiels, les appelants de cette routine doivent tester la valeur de retour pour le dépassement arithmétique. Notez que RtlAnsiStringToUnicodeSize compte pour la valeur NULL de fin.

Les appelants de RtlAnsiStringToUnicodeSize doivent s’exécuter sur IRQL = PASSIVE_LEVEL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 2000.
Plateforme cible Universal
En-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Voir aussi

RtlAnsiStringToUnicodeString

RtlxAnsiStringToUnicodeSize