Funzione RtlUpcaseUnicodeStringToOemString (ntifs.h)

Articolo
02/07/2025

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 tale 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 RtlUpcaseUnicodeUnicodeStringToOemString 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

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

Osservazioni

RtlUpcaseUnicodeStringToOemString converte la stringa di origine specificata usando la tabella codici OEM installata come tabella codici di sistema corrente in fase di avvio del sistema e converte la stringa OEM in maiuscolo.

Questa routine può sostituire un carattere predefinito nella stringa di destinazione per tutti i caratteri della 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).