RtlOemStringToCountedUnicodeString, fonction (ntifs.h)

Article
02/07/2025

La routine RtlOemStringToCountedUnicodeString convertit la chaîne source spécifiée en chaîne Unicode à l’aide de la page de codes OEM système actuelle.

Syntaxe

NTSYSAPI NTSTATUS RtlOemStringToCountedUnicodeString(
       PUNICODE_STRING DestinationString,
  [in] PCOEM_STRING    SourceString,
  [in] BOOLEAN         AllocateDestinationString
);

Paramètres

DestinationString

Pointeur vers une mémoire tampon allouée par l’appelant pour recevoir la chaîne Unicode traduite. Si AllocateDestinationString est FALSE, l’appelant doit également allouer une mémoire tampon pour le membre Buffer de DestinationString pour contenir les données Unicode. Si AllocateDestinationString est TRUE, RtlOemStringToCountedUnicodeString alloue une mémoire tampon suffisamment grande pour contenir la chaîne, lui transmet un pointeur dans tampon, et met à jour la longueur et les membres de longueur maximale de DestinationString en conséquence.

[in] SourceString

Pointeur vers la chaîne OEM à traduire en Unicode.

[in] AllocateDestinationString

Défini sur TRUE si RtlOemStringToCountedUnicodeString doit allouer l’espace tampon pour le DestinationString, FALSE sinon. Si ce paramètre est TRUE, l’appelant est chargé de libérer la mémoire tampon lorsqu’il n’est plus nécessaire en appelant RtlFreeUnicodeString.

Valeur de retour

Si l’opération réussit, RtlOemStringToCountedUnicodeString retourne STATUS_SUCCESS. Sinon, aucun stockage n’a été alloué et aucune conversion n’a été effectuée.

Remarques

RtlOemStringToCountedUnicodeString retourne une chaîne traduite qui n’inclut pas de fin NULL. Elle traduit la chaîne source donnée à l’aide de la page de codes OEM installée en tant que page de codes système actuelle au moment du démarrage.

RtlOemStringToCountedUnicodeString ne modifie pas la chaîne source.

Pour plus d’informations sur les autres routines de gestion des chaînes, consultez Run-Time Routines de bibliothèque (RTL).