Función IsNormalizedString (winnls.h)

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

Syntax

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.

Observaciones

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.

Examples

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

Requisitos

Consulte también

NORM_FORM

de compatibilidad con idiomas nacionales

funciones de compatibilidad con idiomas nacionales

NormalizeString

Usar la normalización Unicode para representar cadenas