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

Функция SccDirQueryInfo

  • Статья

Эта функция проверяет список полных каталогов для их текущего состояния.

Синтаксис

SCCRTN SccDirQueryInfo(
LPVOID  pContext,
LONG    nDirs,
LPCSTR* lpDirNames,
LPLONG  lpStatus
);

Параметры

pContext

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

nDirs

[in] Количество выбранных каталогов для запроса.

lpDirNames

[in] Массив полных путей к запросам каталогов.

lpStatus

[in, out] Структура массива для подключаемого модуля управления версиями для возврата флагов состояния (дополнительные сведения см. в коде состояния каталога).

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

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

значение Описание
SCC_OK Запрос выполнен успешно.
SCC_E_OPNOTSUPPORTED Система управления исходным кодом не поддерживает эту операцию.
SCC_E_ACCESSFAILURE Возникла проблема с доступом к системе управления версиями, вероятно, из-за проблем с сетью или спором. Рекомендуется повторить попытку.
SCC_E_NONSPECIFICERROR

SCC_E_UNKNOWNERROR		 Неспецифический сбой.

Замечания

Функция заполняет возвращаемый массив битами битов из SCC_DIRSTATUS семейства (см . код состояния каталога), одна запись для каждого указанного каталога. Массив состояния выделяется вызывающим объектом.

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

Примечание.

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

См. также