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

Функция SccQueryInfo

  • Статья

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

Синтаксис

SCCRTN SccQueryInfo(
   LPVOID  pvContext,
   LONG    nFiles,
   LPCSTR* lpFileNames,
   LPLONG  lpStatus
);

Параметры

pvContext

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

nFiles

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

lpFileNames

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

lpStatus

[in, out] Массив, в котором подключаемый модуль управления версиями возвращает флаги состояния для каждого файла. Дополнительные сведения см. в разделе "Код состояния файла".

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

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

значение Описание
SCC_OK Запрос выполнен успешно.
SCC_E_ACCESSFAILURE Возникла проблема с доступом к системе управления версиями, вероятно, вызвана проблемами сети или состязаний. Рекомендуется повторить попытку.
SCC_E_PROJNOTOPEN Проект не открыт под управлением версиями.
SCC_E_NONSPECIFICERROR Неспецифический сбой.

Замечания

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

Возвращаемый массив может быть битовой SCC_STATUS_xxxx маской битов. Дополнительные сведения см. в разделе "Код состояния файла". Система управления версиями может не поддерживать все битовые типы. Например, если SCC_STATUS_OUTOFDATE оно не предлагается, бит просто не задан.

При использовании этой функции для проверка файлов обратите внимание на следующие MSSCCI требования к состоянию:

  • SCC_STATUS_OUTBYUSERустанавливается, когда текущий пользователь проверка выдал файл.

  • SCC_STATUS_CHECKEDOUT не может быть задано, если SCC_STATUS_OUTBYUSER не задано.

  • SCC_STATUS_CHECKEDOUTустанавливается только в том случае, если файл проверка отключено в указанный рабочий каталог.

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

См. также