通过

SccQueryInfo 函数

此函数获取的状态信息将所选文件受源代码管理。

SCCRTN SccQueryInfo(
   LPVOID  pvContext,
   LONG    nFiles,
   LPCSTR* lpFileNames,
   LPLONG  lpStatus
);

参数

  • pvContext
    [in] 源代码管理插件上下文结构。

  • nFiles
    [in] 在 lpFileNames 和 lpStatus 数组的长度指定文件的数字。

  • lpFileNames
    [in] 将查询文件的名称。

  • lpStatus
    [in, out] 源代码管理插件返回该状态的数组为每个文件标记。 有关更多信息，请参见 文件状态代码枚举器。

返回值

此函数的源代码管理插件实现应返回下列值之一:

值

说明

SCC_OK

查询成功。

SCC_E_ACCESSFAILURE

具有访问源代码管理系统的问题，原因可能是由于网络问题或争用。 建议使用重试。

SCC_E_PROJNOTOPEN

该项不是打开在源代码管理。

SCC_E_NONSPECIFICERROR

未指定的错误。

备注

如果 lpFileName 空字符串，当前未更新的状态信息。 否则，为状态信息可能发生更改文件的完整路径名。

返回数组可以是 SCC_STATUS_xxxx 位位掩码。 有关更多信息，请参见 文件状态代码枚举器。 源代码管理系统可能不支持所有位类型。 例如，在中，如果未提供 SCC_STATUS_OUTOFDATE ，位就是没有设置。

当使用此功能检查文件时，请注意以下 MSSCCI 状态要求:

  • ，在当前用户签出文件时，SCC_STATUS_OUTBYUSER 设置。

  • ，除非 SCC_STATUS_OUTBYUSER 设置，SCC_STATUS_CHECKEDOUT 不能设置。

  • ，当文件签入到指定的工作目录时，SCC_STATUS_CHECKEDOUT 进行设置。

  • 除了工作目录外，如果文件由当前用户签入内容， SCC_STATUS_OUTBYUSER 设置，但 SCC_STATUS_CHECKEDOUT 不是。

请参见

参考

文件状态代码枚举器

概念

源代码管理插件 API 函数