RtlOemStringToCountedUnicodeString, fonction (ntifs.h)

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 a la valeur FALSE, l’appelant doit également allouer une mémoire tampon pour le membre Buffer de DestinationString afin de contenir 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 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

Affectez la valeur TRUE si RtlOemStringToCountedUnicodeString doit allouer l’espace tampon pour DestinationString, sinon, FALSE . Si ce paramètre a la valeur 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 la marque de fin NULL. Il 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 Routines de bibliothèque d’exécution (RTL).

Configuration requise

   
Plateforme cible Universal
En-tête ntifs.h (include Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Voir aussi

OEM_STRING

RtlFreeUnicodeString

RtlOemStringToCountedUnicodeSize

RtlOemStringToCountedUnicodeString

RtlOemToUnicodeN

UNICODE_STRING