Funzione RtlUnicodeStringToOemString (ntifs.h)

Articolo
02/07/2025

La routine RtlUnicodeStringToOemString converte una stringa di origine Unicode specificata 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 di dimensioni sufficienti per contenere la stringa, passa un puntatore a esso in Buffere 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 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.

Osservazioni

RtlUnicodeStringToOemString converte la stringa di origine specificata usando la tabella codici OEM installata come tabella codici di sistema corrente in fase 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).