StrCmpNIA 函数 (shlwapi.h)

  • 项目

比较两个字符串开头的指定数量的字符，以确定它们是否相同。 该比较不区分大小写。 StrNCmpI 宏仅在名称上不同于此函数。

语法

int StrCmpNIA(
  [in] PCSTR psz1,
  [in] PCSTR psz2,
  [in] int   nChar
);

参数

[in] psz1

类型： PCTSTR

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

[in] psz2

类型： PCTSTR

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

[in] nChar

类型： int

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

返回值

类型： int

如果字符串相同，则返回零。 如果 psz1 指向的字符串的前 nChar 字符大于 psz2 指向的字符串中的字符，则返回正值。 如果 psz1 指向的字符串的前 nChar 字符小于 psz2 指向的字符串中的 nChar 字符，则返回负值。

注解

注意

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

要求

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