POPLISTFUNC

Статья
05/18/2015

Этот обратный вызов передается в Функция SccPopulateList интегрированная среда разработки и использует подключаемым модулем системы управления версиями для обновления списка файлов или каталогов (также предоставленных к SccPopulateList функция).

Когда пользователь выбирает Получить команда в интегрированной среде разработки, интегрированная среда разработки отображается список всех файлов, которые пользователь может получить. К сожалению, интегрированная среда разработки не известен точный список всех файлов, которые пользователь может получить. только подключаемый модуль содержит этот список. Если другие пользователи, добавленные файлы в проект управления исходным кодом, то эти файлы должны появляться в списке, но интегрированная среда разработки не знает о них. Интегрированная среда разработки создает список файлов, что она думает пользователь может получить. Прежде чем она отображает данный список пользователю, он вызывает Функция SccPopulateList, отдавая подключаемому модулю системы управления версиями возможность добавлять и удалять файлы из списка.

Сигнатура

Подключаемый модуль системы управления версиями изменяет список путем вызова - это Интегрированная среда разработки-снабженная функцию следующим прототипом:

typedef BOOL (*POPLISTFUNC) (
   LPVOID pvCallerData,
   BOOL fAddRemove,
   LONG nStatus,
   LPSTR lpFileName
);

Параметры

pvCallerData
pvCallerData параметр, переданный вызывающим (ide) Функция SccPopulateList. Подключаемый модуль системы управления версиями не должен принимать никаких действий о содержимом данного параметра.
fAddRemove
If TRUE" lpFileName файл, который должен быть добавлен в список файлов. If FALSE" lpFileName файл, который должен быть удален из списка файлов.
nStatus
Состояние lpFileName (комбинация SCC_STATUS биты; см. Перечислитель кодов состояния файлов дополнительные сведения).
lpFileName
Полный путь к каталогу имени файла, которое требуется добавить или удалить из списка.

Возвращаемое значение

Значение	Описание
TRUE	Подключаемый модуль может продолжать вызывать эту функцию.
FALSE	Проблема на стороне среды разработки (например из ситуаций памяти). Подключаемый модуль должен остановить операцию.

Заметки

Для каждого файла, подключаемый модуль системы управления версиями необходимо добавить или удалить из списка файлов, он вызывает данную функцию, передавая lpFileName. fAddRemove пометить отображается новый файл для добавления в список или старому файлу для удаления. nStatus параметр дает состояние файла. Когда подключаемый модуль SCC закончил добавление и удаление файлов возвращается из Функция SccPopulateList вызов.

Примечание

SCC_CAP_POPULATELIST бит возможности, необходимые для Visual Studio.