Função StrIsIntlEqualW (shlwapi.h)

Compara um número especificado de caracteres do início de duas cadeias de caracteres para determinar se eles são iguais.

Sintaxe

BOOL StrIsIntlEqualW(
       BOOL   fCaseSens,
  [in] PCWSTR pszString1,
  [in] PCWSTR pszString2,
       int    nChar
);

Parâmetros

fCaseSens

Tipo: BOOL

A confidencialidade de maiúsculas e minúsculas da comparação. Se esse valor não for zero, a comparação diferencia maiúsculas de minúsculas. Se esse valor for zero, a comparação não diferencia maiúsculas de minúsculas.

[in] pszString1

Tipo: PCTSTR

Um ponteiro para a primeira cadeia de caracteres terminada em nulo a ser comparada.

[in] pszString2

Tipo: PCTSTR

Um ponteiro para a segunda cadeia de caracteres terminada em nulo a ser comparada.

nChar

Tipo: int

O número de caracteres desde o início de cada cadeia de caracteres a ser comparada.

Valor retornado

Tipo: BOOL

TRUE se os primeiros caracteres nChar das duas cadeias de caracteres forem iguais; caso contrário, FALSE.

Comentários

Você pode definir a confidencialidade de maiúsculas e minúsculas com as macros StrIntlEqN e StrIntlEqNI . StrIntlEqN executa uma comparação que diferencia maiúsculas de minúsculas e StrIntlEqNI executa uma comparação que não diferencia maiúsculas de minúsculas.

A sintaxe das duas macros é:

#define StrIntlEqN(s1, s2, nChar) StrIsIntlEqual(TRUE, s1, s2, nChar)
#define StrIntlEqNI(s1, s2, nChar) StrIsIntlEqual(FALSE, s1, s2, nChar)

Observação

O cabeçalho shlwapi.h define StrIsIntlEqual como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 4.71 ou posterior)