Funzione RtlDowncaseUnicodeString (ntifs.h)

La routine RtlDowncaseUnicodeString converte la stringa di origine Unicode specificata in lettere minuscole. La traduzione è conforme alle informazioni sulle impostazioni locali del sistema correnti.

Sintassi

NTSYSAPI NTSTATUS RtlDowncaseUnicodeString(
       PUNICODE_STRING  DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Parametri

DestinationString

Puntatore a un buffer allocato dal chiamante per ricevere la stringa Unicode convertita. Se AllocateDestinationString è FALSE, il chiamante deve allocare anche un buffer per il membro Buffer di DestinationString per contenere i dati Unicode. Se AllocateDestinationString è TRUE, RtlDowncaseUnicodeString alloca un buffer sufficientemente grande per contenere la stringa, passa un puntatore a esso nel buffer e aggiorna di conseguenza la lunghezza e i membri di lunghezza massima di DestinationString .

[in] SourceString

Puntatore alla stringa Unicode di origine da convertire in lettere minuscole.

[in] AllocateDestinationString

Impostare su TRUE se RtlDowncaseUnicodeString 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 RtlFreeUnicodeString.

Valore restituito

Se l'operazione ha esito positivo, RtlDowncaseUnicodeString restituisce STATUS_SUCCESS. In caso contrario, nessuna risorsa di archiviazione è stata allocata e non è stata eseguita alcuna conversione.

Commenti

Se il chiamante imposta AllocateDestinationString su TRUE, RtlDowncaseUnicodeString sostituisce il membro Buffer di DestinationString con un puntatore al buffer allocato. Il valore precedente può essere sovrascritto anche quando la routine restituisce un codice di stato di errore.

RtlDowncaseUnicodeString non modifica la stringa di origine.

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

Requisiti

Vedi anche

RtlFreeUnicodeString

RtlUpcaseUnicodeString

UNICODE_STRING