Función IsNormalizedString (winnls.h)

Artículo
03/08/2023

Comprueba que una cadena se normaliza según Unicode 4.0 TR#15. Para obtener más información, vea Uso de la normalización Unicode para representar cadenas.

Sintaxis

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

Parámetros

[in] NormForm

Formulario de normalización que se va a usar. NORM_FORM especifica los formularios de normalización Unicode estándar.

[in] lpString

Puntero a la cadena que se va a probar.

[in] cwLength

Longitud, en caracteres, de la cadena de entrada, incluido un carácter de terminación NULL. Si este valor es -1, la función da por hecho que la cadena termina en null y calcula la longitud automáticamente.

Valor devuelto

Devuelve TRUE si la cadena de entrada ya está normalizada en el formulario adecuado o FALSE en caso contrario. Para obtener información de error extendida, la aplicación puede llamar a GetLastError, que puede devolver uno de los siguientes códigos de error:

ERROR_INVALID_PARAMETER. Cualquiera de los valores de parámetro no era válido.
ERROR_NO_UNICODE_TRANSLATION. Se encontró unicode no válido en la cadena.
ERROR_SUCCESS. La acción se completó correctamente, pero no produjo ningún resultado.

Si necesita determinar de forma confiable FALSE a partir de una condición de error, debe llamar a SetLastError(ERROR_SUCCESS).

Comentarios

Windows XP, Windows Server 2003:

Ya no se admite.

El archivo de encabezado y dll necesarios forman parte de las API de mitigación de nombres de dominio internacionalizados (IDN) de Microsoft, que ya no están disponibles para su descarga.

Ejemplos

Puede encontrar un ejemplo en el que se muestra el uso de esta función en NLS: Ejemplo de normalización Unicode.

Requisitos


Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	winnls.h (incluya Windows.h)
Archivo DLL	Normaliz.dll
Redistribuible	API de mitigación de nombres de dominio internacionalizados (IDN) de Microsoft enWindows XP con SP2 y versiones posteriores, oWindows Server 2003 con SP1