Fonction RtlOemStringToCountedUnicodeString (ntifs.h)

Article
02/26/2024

La routine RtlOemStringToCountedUnicodeString traduit la chaîne source spécifiée en chaîne Unicode à l’aide de la page de code 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 a la valeur FALSE, l’appelant doit également allouer une mémoire tampon pour que le membre Buffer de DestinationString conserve les données Unicode. Si AllocateDestinationString a la valeur TRUE, RtlOemStringToCountedUnicodeString alloue une mémoire tampon suffisamment grande pour contenir la chaîne, lui transmet un pointeur dans Buffer et met à jour les membres de longueur et de longueur maximale de DestinationString en conséquence.

[in] SourceString

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

[in] AllocateDestinationString

Définissez sur TRUE si RtlOemStringToCountedUnicodeString doit allouer l’espace tampon pour destinationString, FALSE sinon. Si ce paramètre a la valeur TRUE, l’appelant est chargé de libérer la mémoire tampon quand elle n’est plus nécessaire en appelant RtlFreeUnicodeString.

Valeur retournée

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 terminaison NULL. Il traduit la chaîne source donnée à l’aide de la page de code OEM qui a été installée en tant que page de code système actuelle au démarrage.

RtlOemStringToCountedUnicodeString ne modifie pas la chaîne source.

Pour plus d’informations sur d’autres routines de gestion de chaînes, consultez Routines de la bibliothèque d’exécution (RTL).