SccDirQueryInfo 函数

此函数检查其当前状态的完全限定目录的列表。

语法

SCCRTN SccDirQueryInfo(
LPVOID  pContext,
LONG    nDirs,
LPCSTR* lpDirNames,
LPLONG  lpStatus
);

参数

pContext

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

nDirs

[in]选择要查询的目录数。

lpDirNames

[in]要查询的目录的完全限定路径的数组。

lpStatus

[in， out]源代码管理插件返回状态标志的数组结构（有关详细信息，请参阅 目录状态代码 ）。

返回值

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

值	说明
SCC_OK	查询成功。
SCC_E_OPNOTSUPPORTED	源代码控制系统不支持此操作。
SCC_E_ACCESSFAILURE	访问源代码管理系统时出现问题，可能是因为网络或争用问题。 建议重试。
SCC_E_NONSPECIFICERROR SCC_E_UNKNOWNERROR	非特定故障。

备注

该函数使用系列（请参阅目录状态代码）中的位SCC_DIRSTATUS掩码填充返回数组，每个目录都有一个条目。 状态数组由调用方分配。

IDE 在将目录重命名为检查目录是否在源代码管理下，方法是查询该目录是否具有相应的项目。 如果目录不在源代码管理下，IDE 可以向用户提供正确的警告。

注意

如果源代码管理插件选择不实现一个或多个状态值，则应将未实现的位设置为零。

另请参阅

• 源代码管理插件 API 函数
• 目录状态代码