Funzione IsNormalizedString (winnls.h)

Articolo
03/08/2023

Verifica che una stringa sia normalizzata in base a Unicode 4.0 TR#15. Per altre informazioni, vedere Uso della normalizzazione Unicode per rappresentare stringhe.

Sintassi

BOOL IsNormalizedString(
  [in] NORM_FORM NormForm,
  [in] LPCWSTR   lpString,
  [in] int       cwLength
);

Parametri

[in] NormForm

Modulo di normalizzazione da usare. NORM_FORM specifica i moduli di normalizzazione Unicode standard.

[in] lpString

Puntatore alla stringa da testare.

[in] cwLength

Lunghezza, in caratteri, della stringa di input, incluso un carattere di terminazione Null. Se questo valore è -1, la funzione presuppone che la stringa venga terminata automaticamente e calcola automaticamente la lunghezza.

Valore restituito

Restituisce TRUE se la stringa di input è già normalizzata nel modulo appropriato o FALSE in caso contrario. Per ottenere informazioni sull'errore estese, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.
ERROR_NO_UNICODE_TRANSLATION. L'unicode non valido è stato trovato in stringa.
ERROR_SUCCESS. L'azione è stata completata correttamente, ma non ha restituito risultati.

Se è necessario determinare in modo affidabile FALSE da una condizione di errore, è necessario chiamare SetLastError(ERROR_SUCCESS).

Commenti

Windows XP, Windows Server 2003:

Non più supportata.

Il file di intestazione e la DLL necessari fanno parte delle API di mitigazione IDN (Microsoft Internationalized Domain Name), che non sono più disponibili per il download.

Esempio

Un esempio che mostra l'uso di questa funzione è disponibile in NLS: Esempio di normalizzazione Unicode.

Requisiti


Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winnls.h (includere Windows.h)
DLL	Normaliz.dll
Componente ridistribuibile	API di mitigazione di Microsoft Internationalized Domain Name (IDN) inWindows XP con SP2 e versioni successive oWindows Server 2003 con SP1