Коды ошибок
Если функция API системы управления версиями возвращает ошибку, ожидается, что это один из следующих кодов ошибок. Все ошибки являются отрицательными, предупреждениями или информационными кодами ошибок являются положительными, и успешное выполнение равно 0.
Код ошибки | значение | Описание |
---|---|---|
SCC_I_SHARESUBPROJOK |
7 | Подключаемый модуль поддерживает добавление файлов из системы управления версиями на двух шагах. Дополнительные сведения см. в разделе SccSetOption. |
SCC_I_FILEDIFFERS |
6 | Локальный файл отличается от файла в базе данных системы управления версиями (например, SccDiff может возвращать это значение). |
SCC_I_RELOADFILE |
5 | Локальный файл был изменен во время операции управления версиями; Интегрированная среда разработки должна перезагрузить файл, если это возможно. |
SCC_I_FILENOTAFFECTED |
4 | Файл не затрагивается. |
SCC_I_PROJECTCREATED |
3 | Проект был создан во время операции управления версиями (например, во время вызова SccOpenProject при SCC_OP_CREATEIFNEW указании флага). |
SCC_I_OPERATIONCANCELED |
2 | Операция отменена. |
SCC_I_ADV_SUPPORT |
1 | Подключаемый модуль поддерживает дополнительные параметры для указанной команды. Дополнительные сведения см. в разделе SccGetCommandOptions. |
SCC_OK |
0 | Успешно. |
SCC_E_INITIALIZEFAILED |
-1 | Ошибка: сбой инициализации. |
SCC_E_UNKNOWNPROJECT |
-2 | Ошибка: проект неизвестен. |
SCC_E_COULDNOTCREATEPROJECT |
-3 | Ошибка: не удалось создать проект. |
SCC_E_NOTCHECKEDOUT |
-4 | Ошибка: файл не проверка отключен. |
SCC_E_ALREADYCHECKEDOUT |
-5 | Ошибка: файл уже проверка отключен. |
SCC_E_FILEISLOCKED |
-6 | Ошибка: файл заблокирован. |
SCC_E_FILEOUTEXCLUSIVE |
-7 | Ошибка: файл является исключительно проверка отключен. |
SCC_E_ACCESSFAILURE |
-8 | Возникла проблема с доступом к системе управления версиями, вероятно, из-за проблем с сетью или спором. Рекомендуется повторить попытку. |
SCC_E_CHECKINCONFLICT |
–9 | Ошибка: во время проверка в ней произошел конфликт. |
SCC_E_FILEALREADYEXISTS |
-10 | Ошибка: файл уже существует. |
SCC_E_FILENOTCONTROLLED |
-11 | Ошибка: файл не находится под управлением версиями. |
SCC_E_FILEISCHECKEDOUT |
-12 | Ошибка: файл проверка отключен. |
SCC_E_NOSPECIFIEDVERSION |
13- | Ошибка: не указана указанная версия. |
SCC_E_OPNOTSUPPORTED |
–14 | Ошибка: операция не поддерживается. |
SCC_E_NONSPECIFICERROR |
15- | Невидимая ошибка. |
SCC_E_OPNOTPERFORMED |
16- | Ошибка, операция не выполнена. |
SCC_E_TYPENOTSUPPORTED |
–17 | Ошибка: тип файла, например двоичного файла, не поддерживается системой управления исходным кодом. |
SCC_E_VERIFYMERGE |
-18 | Файл был автоматически объединен, но не был проверка, так как он ожидает проверки пользователя. |
SCC_E_FIXMERGE |
–19 | Файл был автоматически объединен, но не был проверка в связи с конфликт слияния, который должен быть разрешен вручную. |
SCC_E_SHELLFAILURE |
-20 | Ошибка из-за сбоя оболочки. |
SCC_E_INVALIDUSER |
21 | Ошибка: пользователь недопустим. |
SCC_E_PROJECTALREADYOPEN |
–22 | Ошибка: проект уже открыт. |
SCC_E_PROJSYNTAXERR |
–23 | Ошибка синтаксиса проекта. |
SCC_E_INVALIDFILEPATH |
24- | Ошибка: недопустимый путь к файлу. |
SCC_E_PROJNOTOPEN |
–25 | Ошибка: проект не открыт. |
SCC_E_NOTAUTHORIZED |
–26 | Ошибка: пользователь не авторизован для выполнения этой операции. |
SCC_E_FILESYNTAXERR |
+27 | Ошибка синтаксиса файла. |
SCC_E_FILENOTEXIST |
–28 | Ошибка, локальный файл не существует. |
SCC_E_CONNECTIONFAILURE |
–29 | Ошибка: произошел сбой подключения. |
SCC_E_UNKNOWNERROR |
-30 | Неизвестную погрешность. |
SCC_E_BACKGROUNDGETINPROGRESS |
–31 | В настоящее время выполняется операция фонового получения. |
Макросы, предоставляемые для быстрого проверка
IS_SCC_ERROR(rtn) (((rtn) < 0) ? TRUE : FALSE)
IS_SCC_SUCCESS(rtn) (((rtn) == SCC_OK) ? TRUE : FALSE)
IS_SCC_WARNING(rtn) (((rtn) > 0) ? TRUE : FALSE)
Замечания
Ожидается, что все функции подключаемого модуля управления версиями (за исключением SccAdd, SccCheckin и SccDiff) выполняются успешно, если локальные файлы, передаваемые в качестве аргументов, не существуют в рабочей папке. Например, интегрированная среда разработки может вызвать SccCheckout или SccUn проверка out файла, который не существует в рабочей папке, но существует в системе управления версиями. Этот вызов будет выполнен успешно. Только если файл отсутствует в рабочей папке или в системе управления версиями, ожидается, что функция завершится ошибкой.
Некоторые функции, такие как SccAdd
и SccCheckin
, в частности, должны возвращать SCC_E_FILENOTEXIST
, когда файл в рабочей папке не существует. Другие функции должны быть успешными, если рабочий файл не существует, если функции работают с допустимым именем файла в системе управления версиями.
Подключаемый модуль управления версиями не должен делать предположений о привилегиях файла в рабочей папке, даже если подключаемый модуль помечает файл только для чтения во время некоторых операций. Файл в рабочей папке можно переместить, удалить и изменить вне элемента управления подключаемым модулем.