SccRunScc 函数

此函数调用源代码管理管理工具。

语法

SCCRTN SccRunScc(
   LPVOID  pvContext,
   HWND    hWnd,
   LONG    nFiles,
   LPCSTR* lpFileNames
);

参数

pvContext

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

hWnd

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

nFiles

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

lpFileNames

[in]所选文件名的数组。

返回值

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

值	说明
SCC_OK	已成功调用源代码管理管理工具。
SCC_I_OPERATIONCANCELED	操作已取消。
SCC_E_INITIALIZEFAILED	无法初始化源代码管理系统。
SCC_E_ACCESSFAILURE	访问源代码管理系统时出现问题，可能是因为网络或争用问题。
SCC_E_CONNECTIONFAILURE	无法连接到源代码管理系统。
SCC_E_FILENOTCONTROLLED	所选文件不在源代码管理下。
SCC_E_NONSPECIFICERROR	非特定故障。

备注

此函数允许调用方通过外部管理工具访问源代码管理系统的全部功能。 如果源代码管理系统没有用户界面，源代码管理插件可以实现接口来执行必要的管理功能。

此函数是使用当前所选文件的计数和文件名数组调用的。 如果管理工具支持它，则可以使用文件列表在管理界面中预先选择文件;否则，可以忽略列表。

当用户从“文件->源代码管理”菜单中选择“启动<源代码管理服务器>”时，通常会调用此函数。 可以通过设置注册表项来始终禁用甚至隐藏此 “启动 ”菜单选项。 有关详细信息，请参阅 “如何：安装源代码管理插件 ”。 仅当 SccInitialize 返回 SCC_CAP_RUNSCC 功能位时，才会调用此函数（有关此功能和其他功能位的详细信息，请参阅 功能标志 ）。

另请参阅

• 源代码管理插件 API 函数
• 如何：安装源代码管理插件
• 功能标志
• SccInitialize