Funzione RtlUpcaseUnicodeStringToCountedOemString (ntifs.h)

Articolo
02/29/2024

La routine RtlUpcaseUnicodeStringToCountedOemString converte una stringa di origine Unicode specificata in una stringa OEM con conteggio maiuscolo usando la tabella codici OEM di sistema corrente.

Sintassi

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

Parametri

DestinationString

Puntatore a un buffer allocato dal chiamante per ricevere la stringa OEM 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, RtlUpcaseUnicodeStringToCountedOemString alloca un buffer di dimensioni sufficienti per contenere la stringa, passa un puntatore a esso nel 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 RtlUpcaseUnicodeStringToCountedOemString 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

RtlUpcaseUnicodeStringToCountedOemString restituisce STATUS_SUCCESS se restituisce una stringa tradotta in DestinationString. In caso contrario, nessuna risorsa di archiviazione è stata allocata, né è stata eseguita alcuna conversione. Restituisce STATUS_UNMAPPABLE_CHARACTER se non è in grado di tradurre un carattere nell'oggetto SourceString specificato.

Commenti

RtlUpcaseUnicodeStringToCountedOemString restituisce una stringa non terminata da 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 e converte la stringa tradotta in lettere maiuscole.

Per trovare un mapping ottimale per qualsiasi carattere speciale, ad esempio un carattere di copyright, nella stringa di origine specificata, RtlUpcaseUnicodeStringToCountedOemString esegue le operazioni seguenti:

Converte una copia della stringa Unicode in SourceString in una stringa OEM
Converte nuovamente la stringa OEM in Unicode
Converte questa nuova stringa Unicode in lettere maiuscole
Converte la stringa Unicode maiuscola in una stringa OEM conteggiata e la restituisce in DestinationString

Questa routine non modifica la stringa di origine.

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