Коды ошибок
Когда функция API системы управления версиями подключаемый модуль возвращает ошибку, предполагается, что один из кодов об ошибке. Любые ошибки, предупреждения или отрицательные коды информационной ошибки положительными, а успешное завершение 0.
Код ошибки |
Значение |
Описание |
|---|---|---|
SCC_I_SHARESUBPROJOK |
7 |
Подключаемый модуль поддерживает добавление файлов из системы управления версиями в шаге 2. Дополнительные сведения см. в разделе Функция 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 |
Ошибка: тип файла, например binary не поддерживается системой управления исходным кодом. |
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 |
Операция Get фона в данный момент. |
Макросы предоставленные для быстрой проверки
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)
Заметки
Все функции API системы управления версиями подключаемых (кроме Функция SccAdd" Функция SccCheckinи Функция SccDiff) предпологайте, что успешным, если локальные файлы, которые передаются как аргументы не существуют в рабочей папке. Например, интегрированная среда разработки может выдать вызов Функция SccCheckout OR Функция SccUncheckout в файле, не существующее в рабочей папке, но существует в системе управления версиями. Этот вызов будет выполнен успешно. Только в том случае, если для нее не предусмотрен файл в рабочей папке или в системе системы управления версиями не является функции, которые завершится ошибкой.
Некоторые функции, например SccAdd и SccCheckin, в частности возврата SCC_E_FILENOTEXIST если файл не существует в рабочей папке. Предполагается, что другие функции действия выполняются успешно, если файл не существует, если функции оперируют допустимое имя файла в системе управления версиями.
Подключаемый модуль системы управления версиями не должен делать никаких предположений относительно привилегий файлов в рабочей папке, даже если подключаемый модуль пометил файл доступен только для чтения во время выполнения некоторой операции. Файл в рабочей папке можно перемещать, удалять и изменять за пределами элемента управления plug-in.