Funzione RtlUnicodeStringToOemString (ntifs.h)

Articolo
02/29/2024

La routine RtlUnicodeStringToOemString converte una determinata stringa di origine Unicode in una stringa OEM usando la tabella codici OEM di sistema corrente.

Sintassi

NTSYSAPI NTSTATUS RtlUnicodeStringToOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Parametri

DestinationString

Puntatore a un buffer allocato dal chiamante per ricevere la stringa OEM. Se AllocateDestinationString è FALSE, il chiamante deve allocare anche un buffer per il membro Buffer di DestinationString per contenere i dati OEM. Se AllocateDestinationString è TRUE, RtlUnicodeStringToOemString alloca un buffer sufficientemente grande da 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 Unicode da tradurre.

[in] AllocateDestinationString

Impostare su TRUE se RtlUnicodeStringToOemString 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 RtlFreeOemString.

Valore restituito

RtlUnicodeStringToOemString restituisce STATUS_SUCCESS se la stringa in DestinationString viene convertita. In caso contrario, non è stata allocata alcuna risorsa di archiviazione e non è stata eseguita alcuna conversione.

Commenti

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

RtlUnicodeStringToOemString non modifica la stringa di origine. Restituisce una stringa OEM con terminazione Null.

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