QUERYCHANGESFUNC

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

SccQueryChanges функции предоставляют список файлов и указатель QUERYCHANGESFUNC обратный вызов. Подключаемый модуль системы управления версиями перечисляет заданным списком и предоставляющий состояние (через этот обратный вызов) для каждого файла в списке.

Сигнатура

typedef BOOL (*QUERYCHANGESFUNC)(
   LPVOID pvCallerData,
   QUERYCHANGESDATA * pChangesData
);

Параметры

• pvCallerData
  [in] pvCallerData параметр, переданный вызывающим (ide) Функция SccQueryChanges. Подключаемый модуль системы управления версиями не должен делать никаких предположений о содержимом данного значения.

• pChangesData
  [in] указатель на a QUERYCHANGESDATA структура, описывающие изменения к файлу.

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

Интегрированная среда разработки возвращает соответствующий код ошибки:

Значение	Описание
SCC_OK	Кнопка продолжить обработку.
SCC_I_OPERATIONCANCELED	Остановить обработку.
SCC_E_xxx	Любая соответствующая ошибка SCC должна остановить обработку.

Структура QUERYCHANGESDATA

Структура, переданная в пределах каждого файла выглядит следующим образом:

struct QUERYCHANGESDATA_A
{
    DWORD  dwSize;
    LPCSTR lpFileName;
    DWORD  dwChangeType;
    LPCSTR lpLatestName;
};

typedef struct QUERYCHANGESDATA_A QUERYCHANGESDATA;

struct QUERYCHANGESDATA_W
{
    DWORD   dwSize;
    LPCWSTR lpFileName;
    DWORD   dwChangeType;
    LPCWSTR lpLatestName;
};

• dwSize
  Размер структуры (в байтах).

• lpFileName
  Исходное имя файла для данного элемента.

• dwChangeType
  Код, указывающий состояние файла:

  Код	Описание
  SCC_CHANGE_UNKNOWN	Невозможно указать, что изменилось.
  SCC_CHANGE_UNCHANGED	Нет перемен имя для данного файла.
  SCC_CHANGE_DIFFERENT	Файл с другим идентификатором, однако одинаковые имена существующих в базе данных.
  SCC_CHANGE_NONEXISTENT	Файл не существует или в базе данных или локально.
  SCC_CHANGE_DATABASE_DELETED	Файл удаленный в базе данных.
  SCC_CHANGE_LOCAL_DELETED	Файл удален локально, но файл все еще существуют в базе данных. Если это не удается определить, верните SCC_CHANGE_DATABASE_ADDED.
  SCC_CHANGE_DATABASE_ADDED	Файл, добавленный к базе данных, но не существует локально.
  SCC_CHANGE_LOCAL_ADDED	Файл не существует в базе данных и создать локальный файл.
  SCC_CHANGE_RENAMED_TO	Файл переименованный или перемещенный в базе данных lpLatestName.
  SCC_CHANGE_RENAMED_FROM	Файл переименованный или перемещенный в базе данных из lpLatestName; если это слишком дорогее отслеживания, верните другой, как пометить SCC_CHANGE_DATABASE_ADDED.

• lpLatestName
  Текущее имя файла для данного элемента.

См. также

Ссылки

Функция SccQueryChanges

Основные понятия

Коды ошибок

Другие ресурсы

Обратный вызов функций, реализованных интегрированной средой разработки