Fehlercodes
Wenn eine Quellcodeverwaltungs-Plug-In-API-Funktion einen Fehler zurückgibt, wird erwartet, dass sie eine der folgenden Fehlercodes ist. Alle Fehler sind negativ, Warnungen oder Informationsfehlercodes sind positiv, und der Erfolg ist 0.
Fehlercode | Wert | Beschreibung |
---|---|---|
SCC_I_SHARESUBPROJOK |
7 | Das Plug-In unterstützt das Hinzufügen von Dateien aus der Quellcodeverwaltung in zwei Schritten. Weitere Informationen finden Sie unter SccSetOption. |
SCC_I_FILEDIFFERS |
6 | Die lokale Datei unterscheidet sich von der Datei in der Quellcodeverwaltungsdatenbank (z . B. kann SccDiff diesen Wert zurückgeben). |
SCC_I_RELOADFILE |
5 | Lokale Datei wurde während des Quellcodeverwaltungsvorgangs geändert; die IDE sollte die Datei nach Möglichkeit erneut laden. |
SCC_I_FILENOTAFFECTED |
4 | Die Datei ist nicht betroffen. |
SCC_I_PROJECTCREATED |
3 | Das Projekt wurde während des Quellcodeverwaltungsvorgangs erstellt (z. B. während eines Aufrufs von SccOpenProject , wenn SCC_OP_CREATEIFNEW die Kennzeichnung angegeben wird). |
SCC_I_OPERATIONCANCELED |
2 | Vorgang wurde abgebrochen. |
SCC_I_ADV_SUPPORT |
1 | Plug-In unterstützt erweiterte Optionen für den angegebenen Befehl. Weitere Informationen finden Sie unter SccGetCommandOptions. |
SCC_OK |
0 | Erfolg. |
SCC_E_INITIALIZEFAILED |
-1 | Fehler: Fehler bei der Initialisierung. |
SCC_E_UNKNOWNPROJECT |
-2 | Fehler: Projekt ist unbekannt. |
SCC_E_COULDNOTCREATEPROJECT |
3- | Fehler: Projekt konnte nicht erstellt werden. |
SCC_E_NOTCHECKEDOUT |
-4 | Fehler: Die Datei ist nicht ausgecheckt. |
SCC_E_ALREADYCHECKEDOUT |
-5 | Fehler: Die Datei ist bereits ausgecheckt. |
SCC_E_FILEISLOCKED |
-6 | Fehler: Die Datei ist gesperrt. |
SCC_E_FILEOUTEXCLUSIVE |
-7 | Fehler: Die Datei ist exklusiv ausgecheckt. |
SCC_E_ACCESSFAILURE |
-8 | Es gab ein Problem beim Zugriff auf das Quellcodeverwaltungssystem, wahrscheinlich aufgrund von Netzwerk- oder Inhaltsproblemen. Es wird ein Wiederholungsversuche empfohlen. |
SCC_E_CHECKINCONFLICT |
–9 | Fehler: Während der Überprüfung gab es einen Konflikt. |
SCC_E_FILEALREADYEXISTS |
-10 | Fehler: Die Datei ist bereits vorhanden. |
SCC_E_FILENOTCONTROLLED |
-11 | Fehler: Die Datei befindet sich nicht unter der Quellcodeverwaltung. |
SCC_E_FILEISCHECKEDOUT |
-12 | Fehler: Die Datei ist ausgecheckt. |
SCC_E_NOSPECIFIEDVERSION |
13- | Fehler: Es ist keine angegebene Version vorhanden. |
SCC_E_OPNOTSUPPORTED |
–14 | Fehler: Der Vorgang wird nicht unterstützt. |
SCC_E_NONSPECIFICERROR |
15- | Nicht spezifischer Fehler. |
SCC_E_OPNOTPERFORMED |
16- | Fehler, der Vorgang wurde nicht ausgeführt. |
SCC_E_TYPENOTSUPPORTED |
-17 | Fehler: Der Dateityp, z. B. binär, wird vom Quellcodeverwaltungssystem nicht unterstützt. |
SCC_E_VERIFYMERGE |
-18 | Die Datei wurde automatisch zusammengeführt, wurde aber nicht überprüft, da sie aussteht. |
SCC_E_FIXMERGE |
-19 | Die Datei wurde automatisch zusammengeführt, wurde aber aufgrund eines Zusammenführungskonflikts nicht eingecheckt, der manuell aufgelöst werden muss. |
SCC_E_SHELLFAILURE |
-20 | Fehler aufgrund eines Shellfehlers. |
SCC_E_INVALIDUSER |
-21 | Fehler: Der Benutzer ist ungültig. |
SCC_E_PROJECTALREADYOPEN |
-22 | Fehler: Das Projekt ist bereits geöffnet. |
SCC_E_PROJSYNTAXERR |
-23 | Projektsyntaxfehler. |
SCC_E_INVALIDFILEPATH |
-24 | Fehler: Der Dateipfad ist ungültig. |
SCC_E_PROJNOTOPEN |
-25 | Fehler: Das Projekt ist nicht geöffnet. |
SCC_E_NOTAUTHORIZED |
26- | Fehler: Der Benutzer ist nicht berechtigt, diesen Vorgang auszuführen. |
SCC_E_FILESYNTAXERR |
–27 | Dateisyntaxfehler. |
SCC_E_FILENOTEXIST |
-28 | Fehler, die lokale Datei ist nicht vorhanden. |
SCC_E_CONNECTIONFAILURE |
-29 | Fehler: Verbindungsfehler. |
SCC_E_UNKNOWNERROR |
-30 | Unbekannter Fehler. |
SCC_E_BACKGROUNDGETINPROGRESS |
-31 | Der Hintergrund-Get-Vorgang wird zurzeit ausgeführt. |
Zur schnellen Überprüfung bereitgestellte Makros
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)
Hinweise
Alle Plug-In-API-Funktionen der Quellcodeverwaltung (mit Ausnahme der SccAdd-, SccCheckin- und SccDiff-Funktionen) werden voraussichtlich erfolgreich ausgeführt, wenn die lokalen Dateien, die als Argumente übergeben werden, im Arbeitsordner nicht vorhanden sind. Beispielsweise kann die IDE einen Aufruf von SccCheckout oder SccUncheckout für eine Datei ausgeben, die nicht im Arbeitsordner vorhanden ist, aber im Quellcodeverwaltungssystem vorhanden ist. Dieser Aufruf würde erfolgreich ausgeführt werden. Nur wenn im Arbeitsordner oder im Quellcodeverwaltungssystem keine Datei vorhanden ist, wird erwartet, dass die Funktion fehlschlägt.
Bestimmte Funktionen, z SccAdd
. B. und SccCheckin
, sollten speziell zurückgegeben werden SCC_E_FILENOTEXIST
, wenn die Datei im Arbeitsordner nicht vorhanden ist. Andere Funktionen werden voraussichtlich erfolgreich ausgeführt, wenn die Arbeitsdatei nicht vorhanden ist, wenn die Funktionen einen gültigen Dateinamen im Quellcodeverwaltungssystem verwenden.
Das Quellcodeverwaltungs-Plug-In sollte keine Annahmen hinsichtlich der Berechtigungen für eine Datei im Arbeitsordner treffen, auch wenn das Plug-In die Datei während eines Vorgangs schreibgeschützt markiert hatte. Eine Datei im Arbeitsordner kann verschoben, gelöscht und außerhalb des Steuerelements des Plug-Ins geändert werden.