Condividi tramite


Funzione RtlUpcaseUnicodeToMultiByteN (ntifs.h)

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

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Vedi anche

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteN

RtlUnicodeToMultiByteSize