通过

SccHistory 函数

  • 项目

此函数显示指定文件的历史记录。

语法

SCCRTN SccHistory(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LONG      fOptions,
   LPCMDOPTS pvOptions
);

参数

pvContext

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

hWnd

[in]源代码管理插件可以作为其提供的任何对话框的父级的 IDE 窗口的句柄。

nFiles

[in]数组中指定的 lpFileName 文件数。

lpFileName

[in]文件完全限定名称的数组。

fOptions

[in]命令标志（当前未使用）。

pvOptions

[in]特定于源代码管理插件的选项。

返回值

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

值 说明
SCC_OK 已成功获取版本历史记录。
SCC_I_RELOADFILE 源代码管理系统在获取历史记录时实际修改了磁盘上的文件（例如，通过获取旧版本的文件），因此 IDE 应重新加载此文件。
SCC_E_FILENOTCONTROLLED 该文件不在源代码管理下。
SCC_E_OPNOTSUPPORTED 源代码管理系统不支持此操作。
SCC_E_NOTAUTHORIZED 不允许用户执行此操作。
SCC_E_ACCESSFAILURE 访问源代码管理系统时出现问题，可能是因为网络或争用问题。 建议重试。
SCC_E_PROJNOTOPEN 该项目尚未打开。
SCC_E_NONSPECIFICERROR 非特定故障。 无法获取文件历史记录。

注解

源代码管理插件可以显示其自己的对话框，以显示每个文件的历史记录，用作 hWnd 父窗口。 或者，如果支持，可以使用提供给 SccOpenProject 的可选文本输出回调函数。

请注意，在某些情况下，正在检查的文件在执行此调用期间可能会更改。 例如，Visual Source保险箱 history 命令为用户提供获取旧版文件的机会。 在这种情况下，源代码管理插件会返回 SCC_I_RELOAD 警告 IDE 需要重新加载文件。

注意

如果源代码管理插件不支持文件数组的此函数，则只能显示第一个文件的文件历史记录。

另请参阅