Funzione RtlUnicodeStringToCountedOemString (ntifs.h)

Articolo
08/07/2023

La routine RtlUnicodeStringToCountedOemString converte la stringa di origine Unicode specificata in una stringa OEM con conteggiata usando la tabella codici OEM di sistema corrente.

Sintassi

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

Parametri

DestinationString

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

[in] AllocateDestinationString

Impostare su TRUE se RtlUnicodeStringToCountedOemString 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

RtlUnicodeStringToCountedOemString 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. Questa routine restituisce STATUS_UNMAPPABLE_CHARACTER se non riesce a tradurre un carattere nel valore SourceString specificato.

Commenti

RtlUnicodeStringToCountedOemString restituisce una stringa tradotta che non include un carattere di terminazione NULL. Converte la stringa di origine specificata usando la tabella codici OEM installata come tabella codici di sistema corrente all'ora di avvio del sistema.

RtlUnicodeStringToCountedOemString non modifica la stringa di origine.

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