Функция SccDirDiff

Статья
10/10/2023

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

Синтаксис

SCCRTN SccDirDiff(
   LPVOID    pContext,
   HWND      hWnd,
   LPCSTR    lpDirName,
   LONG      dwFlags,
   LPCMDOPTS pvOptions
);

Параметры

pContext

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

hWnd

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

lpDirName

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

dwFlags

[in] Флаги команд (см. раздел "Примечания").

pvOptions

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

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

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

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

Замечания

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

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

`dwFlags`	Интерпретация
SCC_DIFF_IGNORECASE	Сравнение без учета регистра (может использоваться для быстрого различива или визуального элемента).
SCC_DIFF_IGNORESPACE	Игнорирует пробелы (можно использовать для быстрого или визуального элемента).
SCC_DIFF_QD_CONTENTS	Если поддерживается подключаемым модулем системы управления версиями, автоматически сравнивает каталог, байт байт.
SCC_DIFF_QD_CHECKSUM	Если он поддерживается подключаемым модулем, автоматически сравнивает каталог с помощью проверка sum или, если он не поддерживается, возвращается к SCC_DIFF_QD_CONTENTS.
SCC_DIFF_QD_TIME	Если он поддерживается подключаемым модулем, автоматически сравнивает каталог с помощью метки времени или, если он не поддерживается, возвращается SCC_DIFF_QD_CHECKSUM или SCC_DIFF_QD_CONTENTS.

Примечание.

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

См. также

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

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