此功能将新文件添加到源代码管理系统。
SCCRTN SccAdd(
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames,
LPCSTR lpComment,
LONG* pfOptions,
LPCMDOPTS pvOptions
);
参数
pvContext
[in] 源代码管理插件上下文结构。hWnd
[in] 的句柄到源代码管理插件能用作父级为所有对话框它提供的 IDE 窗口。nFiles
[in] 所选文件的数字被添加到当前项目。对 lpFileNames 数组。lpFileNames
[in] 要添加的文件的完全限定的本地名称。lpComment
[in] 要应用的注释于添加的所有文件。pfOptions
[in] 某些命令，标志，假定基于每个文件的基类型。pvOptions
[in] 源代码管理 " 插件中的选项。
返回值
此函数的源代码管理插件实现应返回下列值之一:
值 |
说明 |
|---|---|
SCC_OK |
添加操作成功。 |
SCC_E_FILEALREADYEXISTS |
选定的文件已在源代码管理。 |
SCC_E_TYPENOTSUPPORTED |
文件的类型 (例如，二进制) 不受源代码管理系统支持。 |
SCC_E_OPNOTSUPPORTED |
源代码管理系统不支持此操作。 |
SCC_E_ACCESSFAILURE |
具有访问源代码管理系统的问题，可能是由于网络问题或争用。 建议使用重试。 |
SCC_E_NOTAUTHORIZED |
用户不允许执行此操作。 |
SCC_E_NONSPECIFICERROR |
未指定的失败;添加未执行。 |
SCC_I_OPERATIONCANCELED |
在操作完成之前已被取消。 |
SCC_I_RELOADFILE |
文件或项目需要重新加载。 |
SCC_E_FILENOTEXIST |
未找到本地文件。 |
备注
通常 fOptions 将数组， pfOptions替换这里，在每个文件的 LONG 选项规范。 这是因为，文件类型可以从文件更改到文件。
备注
它是无效的为同一文件中指定 SCC_FILETYPE_TEXT 和 SCC_FILETYPE_BINARY 选项，但是，它不是有效的指定。，在源代码管理插件自动检测文件类型情况下，设置与设置 SCC_FILETYPE_AUTO。
下面是 pfOptions 数组的标志列表:
选项 |
值 |
含义 |
|---|---|---|
SCC_FILETYPE_AUTO |
0x00 |
源代码管理插件应检测文件类型。 |
SCC_FILETYPE_TEXT |
0x01 |
指示一个 ASCII 文件。 |
SCC_FILETYPE_BINARY |
0x02 |
除了 ASCII 文本内容，指示新的文件类型。 |
SCC_ADD_STORELATEST |
0x04 |
存储文件，而不是增量的最新副本。 |
SCC_FILETYPE_TEXT_ANSI |
0x08 |
将文件作为 ANSI 文本。 |
SCC_FILETYPE_UTF8 |
0x10 |
将文件， Unicode 文本的 UTF8 格式。 |
SCC_FILETYPE_UTF16LE |
0x20 |
将文件，在 UTF16 的 Unicode 文本的 Endian 格式。 |
SCC_FILETYPE_UTF16BE |
0x40 |
将文件， Unicode 文本的 UTF16 用 Endian 格式。 |