Funzione RtlUpcaseUnicodeToOemN (ntifs.h)

Articolo
08/07/2023

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

Sintassi

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToOemN(
  [out]           PCHAR  OemString,
  [in]            ULONG  MaxBytesInOemString,
  [out, optional] PULONG BytesInOemString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Parametri

[out] OemString

Puntatore a un buffer allocato dal chiamante per ricevere la stringa tradotta.

[in] MaxBytesInOemString

Numero massimo di byte da scrivere in OemString.

[out, optional] BytesInOemString

Puntatore a una variabile allocata dal chiamante che riceve il numero di byte nella stringa tradotta. Questo parametro può essere NULL.

[in] UnicodeString

Puntatore alla stringa di origine Unicode da tradurre.

[in] BytesInUnicodeString

Dimensioni, in byte, della stringa in UnicodeString.

Valore restituito

RtlUnicodeToOemN restituisce STATUS_SUCCESS se la stringa completa in UnicodeString è stata convertita correttamente, convertita in maiuscolo e restituita in OemString. In caso contrario, può restituire STATUS_BUFFER_OVERFLOW se la stringa di destinazione deve essere troncata per adattarsi all'oggetto MaxBytesInOemString specificato.

Commenti

Per il valore restituito STATUS_BUFFER_OVERFLOW, la stringa troncata in OemString è stata convertita senza errori.

Per il valore restituito STATUS_SUCCESS, il valore in BytesInOemString, se presente, indica la lunghezza della stringa restituita, anziché il valore MaxBytesInOemString specificato.

Questa routine non modifica la stringa di origine. Restituisce una stringa OEM con terminazione Null se il valore BytesInUnicodeString specificato includeva un carattere di terminazione NULL e se maxBytesInOemString specificato non causava il troncamento.

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