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

Функция SccRename

  • Статья

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

Синтаксис

SCCRTN SccRename(
   LPVOID pvContext,
   HWND   hWnd,
   LPCSTR lpFileName,
   LPCSTR lpNewName
);

Параметры

pvContext

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

hWnd

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

lpFileName

[in] Полное имя файла, переименованного.

lpNewName

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

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

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

значение Описание
SCC_OK Операция переименования завершилась успешно.
SCC_E_PROJNOTOPEN Проект не открыт под управлением версиями.
SCC_E_FILENOTCONTROLLED Файл не находится под управлением версиями.
SCC_E_ACCESSFAILURE Возникла проблема с доступом к системе управления версиями, вероятно, из-за проблем с сетью или спором.
SCC_E_NOTAUTHORIZED Пользователь не авторизован для выполнения этой операции.
SCC_E_COULDNOTCREATEPROJECT Проект не удалось создать как часть процесса переименования.
SCC_E_OPNOTPERFORMED Операция не выполнена.
SCC_E_NONSPECIFICERROR Произошла неопределенная или общая ошибка.

Замечания

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

См. также