StrCmpNIW 函数 (shlwapi.h)

比较两个字符串开头的指定数目的字符,以确定它们是否相同。 比较不区分大小写。 StrNCmpI 宏仅与此函数的名称不同。

语法

int StrCmpNIW(
  [in] PCWSTR psz1,
  [in] PCWSTR psz2,
  [in] int    nChar
);

参数

[in] psz1

类型:PCTSTR

指向要比较的第一个以 null 结尾的字符串的指针。

[in] psz2

类型:PCTSTR

指向要比较的第二个以 null 结尾的字符串的指针。

[in] nChar

类型:int

要比较的每个字符串开头的字符数。

返回值

类型:int

如果字符串相同,则返回零。 如果 psz1 指向的字符串的第一个 nChar 字符大于由 psz2指向的字符串中的字符,则返回正值。 如果 psz1 指向的字符串的第一个 nChar 字符小于 psz2指向的字符串中的字符,则返回负值。

言论

注意

shlwapi.h 标头将 StrCmpNI 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional、Windows XP [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 shlwapi.h
Shlwapi.lib
DLL Shlwapi.dll(版本 4.71 或更高版本)