Função CompareStringWrapW

[CompareStringWrapW está disponível para uso no Windows XP. Ele não estará disponível nas versões subsequentes. Você deve usar CompareStringW em seu lugar.]

Compara duas cadeias de caracteres Unicode, usando uma localidade especificada.

Observação

CompareStringWrapW é um wrapper para a função CompareStringW . Consulte a página CompareString para obter mais notas de uso.

 

Sintaxe

int CompareStringWrapW(
  _In_ LCID    Locale,
  _In_ DWORD   dwCmpFlags,
  _In_ LPCWSTR lpString1,
  _In_ int     cchCount1,
  _In_ LPCWSTR lpString2,
  _In_ int     cchCount2
);

Parâmetros

Localidade [in]

Tipo: LCID

Um identificador de localidade usado para a comparação. Esse parâmetro pode ser um dos seguintes identificadores de localidade predefinidos ou um identificador de localidade criado pela macro MAKELCID .

LOCALE_SYSTEM_DEFAULT

A localidade padrão do sistema.

LOCALE_USER_DEFAULT

A localidade padrão do usuário atual.

dwCmpFlags [in]

Tipo: DWORD

Os sinalizadores que indicam como a função compara as duas cadeias de caracteres. Por padrão, esses sinalizadores não são definidos. Defina como zero para obter o comportamento padrão ou para qualquer combinação dos valores a seguir.

NORM_IGNORECASE

Ignorar maiúsculas e minúsculas.

NORM_IGNOREKANATYPE

Não diferencie entre os caracteres Hiragana e Katakana. Os caracteres Hiragana e Katakana correspondentes são comparados como iguais.

NORM_IGNORENONSPACE

Ignorar caracteres sem espaçamento.

NORM_IGNORESYMBOLS

Ignorar símbolos.

NORM_IGNOREWIDTH

Não diferencie entre um caractere de byte único e o mesmo caractere que um caractere de byte duplo.

SORT_STRINGSORT

Trate a pontuação da mesma forma que símbolos.

lpString1 [in]

Tipo: LPCWSTR

Um ponteiro para a primeira cadeia de caracteres Unicode a ser comparada.

cchCount1 [in]

Tipo: int

O número de caracteres na cadeia de caracteres apontada pelo parâmetro lpString1 . A contagem não inclui o caractere nulo de terminação. Se esse parâmetro for um valor negativo, a cadeia de caracteres será considerada terminada em nulo e o comprimento será calculado automaticamente.

lpString2 [in]

Tipo: LPCWSTR

Um ponteiro para a segunda cadeia de caracteres Unicode a ser comparada.

cchCount2 [in]

Tipo: int

O número de caracteres na cadeia de caracteres apontada pelo parâmetro lpString2 . A contagem não inclui o caractere nulo de terminação. Se esse parâmetro for um valor negativo, a cadeia de caracteres será considerada terminada em nulo e o comprimento será calculado automaticamente.

Valor retornado

Tipo: int

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. GetLastError pode retornar um dos seguintes códigos de erro.

  • ERROR_INVALID_FLAGS
  • ERROR_INVALID_PARAMETER

Se a função for bem-sucedida, o valor retornado será um dos valores a seguir.

Requisito Valor
CSTR_LESS_THAN A cadeia de caracteres apontada pelo parâmetro lpString1 é menor em valor lexical do que a cadeia de caracteres apontada pelo parâmetro lpString2 .
CSTR_EQUAL A cadeia de caracteres apontada por lpString1 é igual em valor lexical à cadeia de caracteres apontada por lpString2.
CSTR_GREATER_THAN A cadeia de caracteres apontada por lpString1 é maior em valor lexical do que a cadeia de caracteres apontada por lpString2

 

Comentários

Aviso de segurança: Usar essa função incorretamente pode comprometer a segurança do aplicativo. Cadeias de caracteres que não são comparadas corretamente podem produzir entrada inválida. Testar cadeias de caracteres para garantir que elas sejam válidas antes de usá-las e fornecer manipuladores de erro. Para obter mais informações, consulte Considerações de segurança: recursos internacionais

O método preferencial é usar CompareStringW em conjunto com a MSLU (Microsoft Layer for Unicode).

CompareStringWrapW deve ser chamado diretamente de Shlwapi.dll, usando o ordinal 45.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Nenhum
DLL
Shlwapi.dll (versão 5.0 ou posterior)

Confira também

CompareString

 

 

  • Last updated on