提供给 SccPopulateList 函数 由 IDE 和源代码管理插件使用该回调更新文件或目录列表 (还提供给 SccPopulateList 函数)。
当用户在 IDE 中 获取 命令，则 IDE 将显示用户可以访问的列表框所有文件。 遗憾的是， IDE 不知道确切用户可以访问的所有文件;只有该插件使此列表。 如果其他用户添加到源代码管理项目的文件，这些文件应出现在列表中，但是， IDE 不知道它们。 IDE 生成文件的列表可识别用户可以访问。 在它显示此列表之前给用户，它调用 SccPopulateList 函数到源代码管理插件的可能性。, 从列表添加和删除文件。
Signature
源代码管理插件通过调用使用以下原型的一个 IDE 中实现的功能修改列表:
typedef BOOL (*POPLISTFUNC) (
LPVOID pvCallerData,
BOOL fAddRemove,
LONG nStatus,
LPSTR lpFileName
);
参数
pvCallerData
pvCallerData 参数已通过调用方 (IDE) 到 SccPopulateList 函数。 源代码管理插件没有应该假定有关此参数内容。fAddRemove
如果 TRUE， lpFileName 是应添加到文件的列表。 如果 FALSE， lpFileName 是应从文件删除的文件列表。nStatus
lpFileName ( SCC_STATUS 位的组合状态;请参见 文件状态代码枚举器 有关详细信息)。lpFileName
添加或删除的文件名的完整目录路径从列表。
返回值
值 |
说明 |
|---|---|
TRUE |
该插件可以继续调用此函数。 |
FALSE |
在 IDE 端的问题 (如内存不足情况外)。 该插件应停止操作。 |
备注
向源代码管理插件添加到或删除从文件列表的每个文件，它调用此函数，并在 lpFileName。 fAddRemove 标志指示新文件添加到列表或旧文件中删除。 nStatus 参数将该文件的状态。 当 SCC 插件完成添加和删除文件时，它会 SccPopulateList 函数 调用返回。
备注
SCC_CAP_POPULATELIST 功能位对于 Visual Studio 是必需的。