Funzione RtlUpcaseUnicodeStringToOemString (ntifs.h)

Articolo
02/26/2024

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

Sintassi

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToOemString(
       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, RtlUpcaseUnicodeStringToOemString alloca un buffer di dimensioni sufficienti per contenere la stringa, passa un puntatore a esso 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 RtlUpcaseUnicodeStringToOemString 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

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

Commenti

RtlUpcaseUnicodeStringToOemString 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 OEM in lettere maiuscole.

Questa routine può sostituire un carattere predefinito nella stringa di destinazione per tutti i caratteri di stringa di origine che non è in grado di eseguire il mapping alla tabella codici corrente e quindi restituire STATUS_SUCCESS.

Questa routine 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).