Поделиться через

Функция SccGetEvents

  • Статья

Эта функция получает очередь событие состояния.

SCCRTN SccGetEvents (
   LPVOID pvContext,
   LPSTR  lpFileName,
   LPLONG lpStatus,
   LPLONG pnEventsRemaining
);

Параметры

  • pvContext
    [in] структура контекста системы управления версиями подключаемых модулей.

  • lpFileName
    [in, out] буфер, в котором подключаемый модуль системы управления версиями помещает возвращаемое имя файла (до символов _MAX_PATH).

  • lpStatus
    [in, out] возвращает код состояния (см. Перечислитель кодов состояния файлов возможные значения).

  • pnEventsRemaining
    [in, out] возвращает число записей, оставляемые в очередь после этого вызова. Если это число больше, то вызывающий может вызвать Функция SccQueryInfo получить все данные одновременно.

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

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

Значение

Описание

SCC_OK

Получите события успешно.

SCC_E_OPNOTSUPPORTED

Эта функция не поддерживается.

SCC_E_NONSPECIFICERROR

Неспецифичный сбой.

Заметки

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

Если обновление состояния для отчета, подключаемый модуль системы управления версиями хранит пустая строка в буфере, заданном в by lpFileName. В противном случае - подключаемый модуль содержит полный путь файла, для которого информация о состоянии изменилась и возвращает соответствующий код состояния (одно из значений детализированных in Перечислитель кодов состояния файлов).

См. также

Ссылки

Перечислитель кодов состояния файлов

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

Функции API подключаемых модулей системы управления версиями