Funzione RtlUpcaseUnicodeToMultiByteN (ntifs.h)

Articolo
03/05/2024

La routine RtlUpcaseUnicodeToMultiByteN converte la stringa Unicode specificata in una nuova stringa di caratteri maiuscoli usando la tabella codici ANSI del sistema corrente (ACP). La stringa tradotta non è necessariamente da un set di caratteri multibyte.

Sintassi

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToMultiByteN(
  [out]           PCHAR  MultiByteString,
  [in]            ULONG  MaxBytesInMultiByteString,
  [out, optional] PULONG BytesInMultiByteString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Parametri

[out] MultiByteString

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

[in] MaxBytesInMultiByteString

Numero massimo di byte da scrivere in MultiByteString. Se questo valore causa il troncamento della stringa tradotta, RtlUpcaseUnicodeToMultiByteN non restituisce uno stato di errore.

[out, optional] BytesInMultiByteString

Puntatore a una variabile allocata dal chiamante che riceve la lunghezza, in byte, della 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

RtlUpcaseUnicodeToMultiByteN restituisce STATUS_SUCCESS.

Commenti

RtlUpcaseUnicodeToMultiByteN converte la stringa Unicode specificata usando la tabella codici ANSI del sistema corrente installata all'ora di avvio del sistema e converte la stringa tradotta in lettere maiuscole.

Questa routine non modifica la stringa di origine. Restituisce una stringa ANSI con terminazione NULL se l'oggetto BytesInUnicodeString specificato includeva un terminatore NULL e se il valore maxBytesInMultiByteString specificato non causava il troncamento.

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