Funzione RtlOemStringToUnicodeString (ntifs.h)

Articolo
08/07/2023

La routine RtlOemStringToUnicodeString converte una determinata stringa di origine in una stringa Unicode con terminazione Null usando la tabella codici OEM di sistema corrente.

Sintassi

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

Parametri

DestinationString

Puntatore a un buffer allocato dal chiamante per ricevere la stringa tradotta. Se AllocateDestinationString è FALSE, il chiamante deve allocare anche un buffer per il membro Buffer di DestinationString per contenere la stringa Unicode con terminazione Null. Se AllocateDestinationString è TRUE, RtlOemStringToUnicodeString alloca un buffer di dimensioni sufficienti per contenere la stringa, passa un puntatore a tale valore in Buffer e aggiorna di conseguenza i membri di lunghezza e lunghezza massima di DestinationString .

[in] SourceString

Puntatore alla stringa OEM da convertire in Unicode.

[in] AllocateDestinationString

Impostare su TRUE se RtlOemStringToUnicodeString deve allocare lo spazio del buffer per DestinationString, FALSE in caso contrario. Se questo parametro è TRUE, il chiamante è responsabile della liberazione del buffer quando non è più necessario chiamando RtlFreeUnicodeString.

Valore restituito

RtlOemStringToUnicodeString restituisce STATUS_SUCCESS se restituisce una stringa tradotta in DestinationString. In caso contrario, non è stata allocata alcuna risorsa di archiviazione e non è stata eseguita alcuna conversione.

Commenti

RtlOemStringToUnicodeString converte la stringa di origine specificata usando la tabella codici OEM installata come tabella codici di sistema corrente all'ora di avvio del sistema.

Questa routine non modifica la stringa di origine. Restituisce una stringa Unicode con terminazione NULL.

Per informazioni su altre routine di gestione delle stringhe, vedere Routine RTL (Run-Time Library).