SccCheckin 函数
此函数检查以前检查出文件到源代码管理系统,存储更改并创建新版本。 此函数使用要在其中检查的文件名称的计数和数组进行调用。
语法
SCCRTN SccCheckin (
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPSTR* lpFileNames,
LPCSTR lpComment,
LONG fOptions,
LPCMDOPTS pvOptions
);
参数
pvContext
[in]源代码管理插件上下文结构。
hWnd
[in]SCC 插件可以作为其提供的任何对话框的父级的 IDE 窗口句柄。
nFiles
[in]选择要在其中检查的文件数。
lpFileNames
[in]要在其中检查的文件的完全限定本地路径名称的数组。
lpComment
[in]要应用于要在其中检查的每个选定文件的注释。 此参数是 NULL
源代码管理插件应提示批注。
fOptions
[in]命令标志,0 或 SCC_KEEP_CHECKEDOUT
.
pvOptions
[in]特定于 SCC 插件的选项。
返回值
此函数的源代码管理插件实现应返回以下值之一:
值 | 说明 |
---|---|
SCC_OK | 文件已成功检查。 |
SCC_E_FILENOTCONTROLLED | 所选文件不在源代码管理下。 |
SCC_E_ACCESSFAILURE | 访问源代码管理系统时出现问题,可能是因为网络或争用问题。 建议重试。 |
SCC_E_NONSPECIFICERROR | 非特定故障。 文件未检查。 |
SCC_E_NOTCHECKEDOUT | 用户尚未检查文件,因此无法检查该文件。 |
SCC_E_CHECKINCONFLICT | 无法执行签入,因为: - 其他用户已提前检查并且 bAutoReconcile 为 false。-或- - 无法完成自动合并(例如,文件为二进制文件时)。 |
SCC_E_VERIFYMERGE | 文件已自动合并,但尚未在挂起的用户验证中检查。 |
SCC_E_FIXMERGE | 由于必须手动解析的合并冲突,文件已自动合并,但尚未检查。 |
SCC_E_NOTAUTHORIZED | 不允许用户执行此操作。 |
SCC_I_OPERATIONCANCELED | 操作在完成前已取消。 |
SCC_I_RELOADFILE | 需要重新加载文件或项目。 |
SCC_E_FILENOTEXIST | 找不到本地文件。 |
注解
注释适用于检查的所有文件。 注释参数可以是字符串 null
,在这种情况下,源代码管理插件可以提示用户输入每个文件的注释字符串。
fOptions
可以为参数指定一个标志值SCC_KEEP_CHECKEDOUT
,以指示用户打算检查文件,并再次检查该文件。