Share via

Функция SccRunScc

  • Статья

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

Синтаксис

SCCRTN SccRunScc(
   LPVOID  pvContext,
   HWND    hWnd,
   LONG    nFiles,
   LPCSTR* lpFileNames
);

Параметры

pvContext

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

hWnd

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

nFiles

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

lpFileNames

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

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

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

значение Описание
SCC_OK Средство администрирования системы управления версиями было успешно вызвано.
SCC_I_OPERATIONCANCELED Операция была отменена.
SCC_E_INITIALIZEFAILED Не удалось инициализировать систему управления версиями.
SCC_E_ACCESSFAILURE Возникла проблема с доступом к системе управления версиями, вероятно, из-за проблем с сетью или спором.
SCC_E_CONNECTIONFAILURE Не удалось подключиться к системе управления версиями.
SCC_E_FILENOTCONTROLLED Выбранный файл не находится под управлением версиями.
SCC_E_NONSPECIFICERROR Неспецифический сбой.

Замечания

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

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

Эта функция обычно вызывается, когда пользователь выбирает сервер> управления <версиями из меню "Файл ->Source Control". Этот параметр меню запуска всегда можно отключить или даже скрыть, задав запись реестра. Дополнительные сведения см. в разделе "Практическое руководство. Установка подключаемого модуля системы управления версиями". Эта функция вызывается только в том случае, если SccInitialize возвращает SCC_CAP_RUNSCC бит возможностей (дополнительные сведения об этом и других битах возможностей см. в разделе "Флаги возможностей").

См. также