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

Функция SccHistory

  • Статья

Эта функция отображает журнал указанных файлов.

Синтаксис

SCCRTN SccHistory(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LONG      fOptions,
   LPCMDOPTS pvOptions
);

Параметры

pvContext

[in] Структура контекста подключаемого модуля управления версиями.

hWnd

[in] Дескриптор окна интегрированной среды разработки, который подключаемый модуль управления версиями может использовать в качестве родительского элемента для любых диалоговых окон, которые он предоставляет.

nFiles

[in] Количество файлов, указанных в массиве lpFileName .

lpFileName

[in] Массив полных имен файлов.

fOptions

[in] Флаги команд (в настоящее время не используются).

pvOptions

[in] Параметры подключаемого модуля управления версиями.

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

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

значение Описание
SCC_OK Журнал версий успешно получен.
SCC_I_RELOADFILE Система управления версиями фактически изменила файл на диске при получении журнала (например, получив старую версию), поэтому интегрированная среда разработки должна перезагрузить этот файл.
SCC_E_FILENOTCONTROLLED Файл не находится под управлением версиями.
SCC_E_OPNOTSUPPORTED Система управления версиями не поддерживает эту операцию.
SCC_E_NOTAUTHORIZED Пользователю не разрешено выполнять эту операцию.
SCC_E_ACCESSFAILURE Возникла проблема с доступом к системе управления версиями, вероятно, из-за проблем с сетью или спором. Рекомендуется повторить попытку.
SCC_E_PROJNOTOPEN Проект не открыт.
SCC_E_NONSPECIFICERROR Неспецифический сбой. Не удалось получить журнал файлов.

Замечания

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

Обратите внимание, что при определенных обстоятельствах проверяемый файл может измениться во время выполнения этого вызова. Например, команда журнала Visual Source Сейф дает пользователю возможность получить старую версию файла. В таком случае подключаемый модуль управления версиями возвращает SCC_I_RELOAD предупреждение интегрированной среды разработки о необходимости перезагрузки файла.

Примечание.

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

См. также