Códigos de error
Cuando una función API del complemento de control de código fuente devuelve un error, es esperada ser uno de los códigos de error siguientes. Todos los errores son negativos, las advertencias o los códigos de error informativos son negativos, y la ejecución correcta es 0.
Código de error |
Valor |
Descripción |
|---|---|---|
SCC_I_SHARESUBPROJOK |
7 |
El complemento admite archivos de adición de control de código fuente en dos pasos. Para obtener más información, vea SccSetOption (Función). |
SCC_I_FILEDIFFERS |
6 |
El archivo local es diferente del archivo en la base de datos de control de código fuente (por ejemplo, SccDiff (Función) puede devolver este valor). |
SCC_I_RELOADFILE |
5 |
El archivo local ha cambiado durante la operación de control de código fuente; el IDE debe recargar el archivo si es posible. |
SCC_I_FILENOTAFFECTED |
4 |
El archivo no se ve afectado. |
SCC_I_PROJECTCREATED |
3 |
El proyecto se creó durante la operación de control de código fuente (por ejemplo, durante una llamada a SccOpenProject (Función) cuando se especifica el indicador de SCC_OP_CREATEIFNEW ). |
SCC_I_OPERATIONCANCELED |
2 |
Se canceló la operación. |
SCC_I_ADV_SUPPORT |
1 |
el complemento admite las opciones avanzadas para el comando especificado. Para obtener más información, vea SccGetCommandOptions (Función). |
SCC_OK |
0 |
Correcto. |
SCC_E_INITIALIZEFAILED |
-1 |
error: la inicialización no. |
SCC_E_UNKNOWNPROJECT |
-2 |
error: el proyecto es desconocido. |
SCC_E_COULDNOTCREATEPROJECT |
-3 |
error: el proyecto no puede crear. |
SCC_E_NOTCHECKEDOUT |
-4 |
error: el archivo no se desprotege. |
SCC_E_ALREADYCHECKEDOUT |
-5 |
error: el archivo está desprotegido en. |
SCC_E_FILEISLOCKED |
-6 |
error: el archivo está bloqueado. |
SCC_E_FILEOUTEXCLUSIVE |
-7 |
error: el archivo se comprueba exclusivamente out. |
SCC_E_ACCESSFAILURE |
-8 |
Hubo un problema que tiene acceso al sistema de control de código fuente, probablemente debido a problemas de red o de contención. se recomienda un intento. |
SCC_E_CHECKINCONFLICT |
-9 |
error: se produjo un conflicto durante proteger. |
SCC_E_FILEALREADYEXISTS |
-10 |
error: el archivo ya existe. |
SCC_E_FILENOTCONTROLLED |
-11 |
error: el archivo no está bajo control de código fuente. |
SCC_E_FILEISCHECKEDOUT |
-12 |
error: el archivo se desprotege. |
SCC_E_NOSPECIFIEDVERSION |
-13 |
error: no hay versión especificada. |
SCC_E_OPNOTSUPPORTED |
-14 |
error: la operación no se admite. |
SCC_E_NONSPECIFICERROR |
-15 |
error no específico. |
SCC_E_OPNOTPERFORMED |
-16 |
El error, la operación no se realizó. |
SCC_E_TYPENOTSUPPORTED |
-17 |
error: el sistema de control de código fuente no admite el tipo de archivo, por ejemplo, binario. |
SCC_E_VERIFYMERGE |
-18 |
Automáticamente ha combinado pero no se ha comprobado el archivo porque es comprobación pendiente de usuario. |
SCC_E_FIXMERGE |
-19 |
El archivo automáticamente ha combinado pero no se ha protegido por un conflicto de combinación que debe resolver manualmente. |
SCC_E_SHELLFAILURE |
-20 |
Error debido a un error de shell. |
SCC_E_INVALIDUSER |
-21 |
error: el usuario no es válido. |
SCC_E_PROJECTALREADYOPEN |
-22 |
error: el proyecto está abierto. |
SCC_E_PROJSYNTAXERR |
-23 |
Error de sintaxis del proyecto. |
SCC_E_INVALIDFILEPATH |
-24 |
error: la ruta de acceso no es válida. |
SCC_E_PROJNOTOPEN |
-25 |
error: el proyecto no está abierto. |
SCC_E_NOTAUTHORIZED |
-26 |
error: el usuario no está autorizado a realizar esta operación. |
SCC_E_FILESYNTAXERR |
-27 |
Error de sintaxis del archivo. |
SCC_E_FILENOTEXIST |
-28 |
el error, el archivo local no existe. |
SCC_E_CONNECTIONFAILURE |
-29 |
error: se produjo un error de conexión. |
SCC_E_UNKNOWNERROR |
-30 |
error desconocido. |
SCC_E_BACKGROUNDGETINPROGRESS |
-31 |
La operación Get de fondo está actualmente en curso. |
Macros Proporcionada para comprobar rápida
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)
Comentarios
Todas las funciones de la API del complemento de control de código fuente (excepto SccAdd (Función), SccCheckin (Función), y SccDiff (Función)) son esperadas tener éxito cuando los archivos locales se pasan como argumentos no existen en la carpeta de trabajo. Por ejemplo, el IDE puede emitir una llamada a SccCheckout (Función) o a SccUncheckout (Función) en un archivo que no existe en la carpeta de trabajo, pero existe en el sistema de control de código fuente. Esta llamada sería correcto. Cuando existe ningún archivo en la carpeta de trabajo o en el sistema de control de código fuente la función esperada errónea.
Algunas funciones, como SccAdd y SccCheckin, deben devolver específicamente SCC_E_FILENOTEXIST cuando no existe el archivo en la carpeta de trabajo. Otras funciones son esperadas tener éxito cuando no existe el archivo que funciona, si las funciones operan en un nombre de archivo válido en el sistema de control de código fuente.
El complemento de control de código fuente no debe tener ninguna idea preconcebida con privilegios en un archivo en la carpeta de trabajo, incluso si el complemento había marcado como de sólo lectura del archivo durante una operación. Un archivo en la carpeta de trabajo se puede mover, eliminar, y cambiar fuera del control del complemento.