Función StrCmpCA (shlwapi.h)
Compara cadenas mediante reglas de intercalación en tiempo de ejecución (ASCII) de C. La comparación distingue mayúsculas de minúsculas.
Sintaxis
int StrCmpCA(
[out] LPCSTR pszStr1,
[out] LPCSTR pszStr2
);
Parámetros
[out] pszStr1
Tipo: LPCSTR de
Puntero a la primera cadena terminada en NULL que se va a comparar.
[out] pszStr2
Tipo: LPCSTR de
Puntero a la segunda cadena terminada en NULL que se va a comparar.
Valor devuelto
Tipo: int
Devuelve cero si las cadenas son idénticas. Devuelve un valor positivo si la cadena a la que apunta lpStr1 es alfabéticamente mayor que la que señala lpStr2. Devuelve un valor negativo si la cadena a la que apunta lpStr1 es alfabéticamente menor que la que señala lpStr2.
Observaciones
Se recomienda encarecidamente usar la función CompareString en lugar de esta función. StrCmpC se diseñó para comparar cadenas canónicas. Estas cadenas no están localizadas y solo constan de caracteres por debajo del valor ASCII 128. Por lo tanto, no funcionará correctamente con un juego de caracteres de doble byte (DBCS) u otros datos de varios caracteres.
Esta función busca los primeros caracteres distintos y devuelve un número positivo si el carácter de la primera cadena es mayor que el carácter del segundo, un número negativo si es menor o cero si son iguales. Por ejemplo, si lpStr1="abczb" y lpStr2="abcdefg", StrCmpC determina que el primer carácter desigual está en la posición cuatro ("z" en lpStr1 y "d" en lpStr2) y devuelve un valor positivo, ya que el código ASCII para "z" es mayor que el código ASCII para "d".
Para aquellas versiones de Windows que no incluyan StrCmpC en Shlwapi.h, se debe llamar a la versión anSI o Unicode individual de esta función directamente desde Shlwapi.dll. StrCmpCA es ordinal 155 y StrCmpCW es ordinal 156.
Nota
El encabezado shlwapi.h define StrCmpC como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
shlwapi.h |
| biblioteca de |
Shlwapi.lib |
| DLL de |
Shlwapi.dll (versión 5.0 o posterior) |