Codes d'erreur
Lorsqu'une fonction API du plug-in du contrôle de code source retourne une erreur, il est recommandé que soit l'un des codes d'erreur suivante. Toutes les erreurs sont négatives, des avertissements ou des codes d'erreur informative sont positifs, et la réussite est 0.
Code d'erreur |
Valeur |
Description |
|---|---|---|
SCC_I_SHARESUBPROJOK |
7 |
Le plug-in prend en charge les ajout de fichiers de contrôle de code source en deux étapes. Pour plus d'informations, consultez SccSetOption, fonction. |
SCC_I_FILEDIFFERS |
6 |
Le fichier local est différent du fichier dans la base de données contenant le contrôle de code source (par exemple, SccDiff, fonction peut retourner cette valeur). |
SCC_I_RELOADFILE |
5 |
le fichier local a été modifié pendant l'opération de contrôle de code source ; l'IDE doit recharger le fichier si possible. |
SCC_I_FILENOTAFFECTED |
4 |
le fichier n'est pas affecté. |
SCC_I_PROJECTCREATED |
3 |
Le projet a été créé pendant l'opération de contrôle de code source (par exemple, lors d'un appel à SccOpenProject, fonction lorsque la balise d' SCC_OP_CREATEIFNEW est spécifiée). |
SCC_I_OPERATIONCANCELED |
2 |
l'opération a été annulée. |
SCC_I_ADV_SUPPORT |
1 |
Le plug-in prend en charge les options avancées de la commande spécifiée. Pour plus d'informations, consultez SccGetCommandOptions, fonction. |
SCC_OK |
0 |
Succès. |
SCC_E_INITIALIZEFAILED |
-1 |
erreur : initialisation a échoué. |
SCC_E_UNKNOWNPROJECT |
-2 |
erreur : le projet est inconnu. |
SCC_E_COULDNOTCREATEPROJECT |
-3 |
erreur : le projet n'a pas pu être créé. |
SCC_E_NOTCHECKEDOUT |
-4 |
erreur : le fichier n'est pas vérifié. |
SCC_E_ALREADYCHECKEDOUT |
-5 |
erreur : le fichier est déjà extrait. |
SCC_E_FILEISLOCKED |
-6 |
erreur : le fichier est verrouillé. |
SCC_E_FILEOUTEXCLUSIVE |
-7 |
erreur : le fichier est exclusivement vérifié. |
SCC_E_ACCESSFAILURE |
-8 |
Un problème est survenu lors de l'accès au système de contrôle de code source, probablement en raison de problèmes de réseau ou de conflit. Une démarrage est recommandée. |
SCC_E_CHECKINCONFLICT |
-9 |
erreur : il existe un conflit pendant archive. |
SCC_E_FILEALREADYEXISTS |
-10 |
erreur : le fichier existe déjà. |
SCC_E_FILENOTCONTROLLED |
-11 |
erreur : le fichier n'est pas sous contrôle de code source. |
SCC_E_FILEISCHECKEDOUT |
-12 |
erreur : le fichier est extrait. |
SCC_E_NOSPECIFIEDVERSION |
-13 |
erreur : il n'existe aucune version spécifiée. |
SCC_E_OPNOTSUPPORTED |
-14 |
erreur : l'opération n'est pas prise en charge. |
SCC_E_NONSPECIFICERROR |
-15 |
erreur non spécifique. |
SCC_E_OPNOTPERFORMED |
-16 |
l'erreur, l'opération n'a pas été effectuée. |
SCC_E_TYPENOTSUPPORTED |
-17 |
erreur : le type du fichier, par exemple, binaire, n'est pas pris en charge par le système de contrôle de code source. |
SCC_E_VERIFYMERGE |
-18 |
Le fichier utilisent été fusionné mais pas activé car il s'agit de vérification en attente d'utilisateur. |
SCC_E_FIXMERGE |
-19 |
Le fichier utilisent été fusionné mais pas signé en raison d'un conflit de fusion qui doit être manuellement résolu. |
SCC_E_SHELLFAILURE |
-20 |
Erreur en raison d'un échec de shell. |
SCC_E_INVALIDUSER |
-21 |
erreur : l'utilisateur est valide. |
SCC_E_PROJECTALREADYOPEN |
-22 |
erreur : le projet est déjà ouvert. |
SCC_E_PROJSYNTAXERR |
-23 |
erreur de syntaxe de projet. |
SCC_E_INVALIDFILEPATH |
-24 |
erreur : le chemin d'accès de fichier est valide. |
SCC_E_PROJNOTOPEN |
-25 |
erreur : le projet n'est pas ouvert. |
SCC_E_NOTAUTHORIZED |
-26 |
erreur : l'utilisateur n'est pas autorisé à exécuter cette opération. |
SCC_E_FILESYNTAXERR |
-27 |
erreur de syntaxe de fichier. |
SCC_E_FILENOTEXIST |
-28 |
l'erreur, le fichier local n'existe pas. |
SCC_E_CONNECTIONFAILURE |
-29 |
erreur : il existe un échec de connexion. |
SCC_E_UNKNOWNERROR |
-30 |
Erreur inconnue. |
SCC_E_BACKGROUNDGETINPROGRESS |
-31 |
L'opération d'obtention d'arrière-plan est en cours. |
Macros données pour la vérification rapide
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)
Remarques
Il est recommandé que toutes les fonctions API du plug-in du contrôle de code source (à l'exception SccAdd, fonction, SccCheckin, fonction, et SccDiff, fonction) réussissent lorsque les fichiers locaux qui sont passés comme les arguments n'existent pas dans le dossier de travail. Par exemple, l'IDE peut fournir un appel à SccCheckout, fonction ou à SccUncheckout, fonction sur un fichier qui n'existe pas dans le dossier de travail, mais se trouve dans le système de contrôle de code source. cet appel réussirait. Uniquement lorsqu'il existe aucun fichier dans le dossier de travail ou dans le système de contrôle de code source n'est la fonction attendue échouer.
Certaines fonctions, telles qu' SccAdd et SccCheckin, doivent spécifiquement retourner SCC_E_FILENOTEXIST lorsque le fichier dans le dossier de travail n'existe pas. Il est recommandé que d'autres fonctions réussissent lorsque le fichier vous travaillez n'existe pas, si les fonctions agissent sur un nom de fichier valide dans le système de contrôle de code source.
Le plug-in contrôle de code source doit faire des suppositions quant à les privilèges sur un fichier dans le dossier de travail, même si le plug-in a marqué le fichier en lecture seule pendant une opération. Un fichier dans le dossier de travail peut être déplacé, supprimé, et modifié en dehors de le contrôle de la connexion.