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) |