Kódy chyb
Pokud funkce rozhraní API modulu plug-in správy zdrojového kódu vrátí chybu, očekává se, že se jedná o jeden z následujících kódů chyb. Všechny chyby jsou záporné, upozornění nebo informační kódy chyb jsou kladné a úspěch je 0.
Kód chyby | Hodnota | Popis |
---|---|---|
SCC_I_SHARESUBPROJOK |
7 | Modul plug-in podporuje přidávání souborů ze správy zdrojového kódu ve dvou krocích. Další informace naleznete v tématu SccSetOption. |
SCC_I_FILEDIFFERS |
6 | Místní soubor se liší od souboru v databázi správy zdrojového kódu (například SccDiff může vrátit tuto hodnotu). |
SCC_I_RELOADFILE |
5 | Místní soubor byl změněn během operace správy zdrojového kódu; pokud je to možné, integrované vývojové prostředí (IDE) by mělo soubor znovu načíst. |
SCC_I_FILENOTAFFECTED |
4 | Soubor není ovlivněn. |
SCC_I_PROJECTCREATED |
3 | Projekt byl vytvořen během operace správy zdrojového kódu (například během volání SccOpenProject při SCC_OP_CREATEIFNEW zadání příznaku). |
SCC_I_OPERATIONCANCELED |
2 | Operace byla zrušena. |
SCC_I_ADV_SUPPORT |
0 | Modul plug-in podporuje pokročilé možnosti zadaného příkazu. Další informace naleznete v tématu SccGetCommandOptions. |
SCC_OK |
0 | Úspěch |
SCC_E_INITIALIZEFAILED |
-1 | Chyba: Inicializace se nezdařila. |
SCC_E_UNKNOWNPROJECT |
-2 | Chyba: projekt je neznámý. |
SCC_E_COULDNOTCREATEPROJECT |
-3 | Chyba: projekt nelze vytvořit. |
SCC_E_NOTCHECKEDOUT |
-4 | Chyba: Soubor není rezervován. |
SCC_E_ALREADYCHECKEDOUT |
-5 | Chyba: Soubor je již rezervován. |
SCC_E_FILEISLOCKED |
-6 | Chyba: Soubor je uzamčen. |
SCC_E_FILEOUTEXCLUSIVE |
-7 | Chyba: Soubor je rezervován výhradně. |
SCC_E_ACCESSFAILURE |
-8 | Při přístupu k systému správy zdrojového kódu došlo k potížím, pravděpodobně kvůli problémům se sítí nebo kolizí. Doporučuje se opakování. |
SCC_E_CHECKINCONFLICT |
-9 | Chyba: Během vrácení se změnami došlo ke konfliktu. |
SCC_E_FILEALREADYEXISTS |
-10 | Chyba: Soubor již existuje. |
SCC_E_FILENOTCONTROLLED |
-11 | Chyba: Soubor není pod správou zdrojového kódu. |
SCC_E_FILEISCHECKEDOUT |
-12 | Chyba: Soubor je rezervován. |
SCC_E_NOSPECIFIEDVERSION |
-13 | Chyba: Neexistuje žádná zadaná verze. |
SCC_E_OPNOTSUPPORTED |
-14 | Chyba: Operace není podporována. |
SCC_E_NONSPECIFICERROR |
-15 | Nespecifická chyba. |
SCC_E_OPNOTPERFORMED |
-16 | Chyba, operace nebyla provedena. |
SCC_E_TYPENOTSUPPORTED |
-17 | Chyba: Systém správy zdrojového kódu nepodporuje typ souboru, například binární soubor. |
SCC_E_VERIFYMERGE |
−18 | Soubor byl automaticky sloučen, ale nebyl zkontrolován, protože čeká na ověření uživatele. |
SCC_E_FIXMERGE |
-19 | Soubor se automaticky sloučil, ale nebyl vrácen se změnami kvůli konfliktu při slučování, který je potřeba vyřešit ručně. |
SCC_E_SHELLFAILURE |
-20 | Chyba způsobená selháním prostředí |
SCC_E_INVALIDUSER |
-21 | Chyba: Uživatel je neplatný. |
SCC_E_PROJECTALREADYOPEN |
-22 | Chyba: Projekt je již otevřen. |
SCC_E_PROJSYNTAXERR |
-23 | Chyba syntaxe projektu |
SCC_E_INVALIDFILEPATH |
-24 | Chyba: Cesta k souboru je neplatná. |
SCC_E_PROJNOTOPEN |
-25 | Chyba: Projekt není otevřen. |
SCC_E_NOTAUTHORIZED |
-26 | Chyba: Uživatel nemá oprávnění k provedení této operace. |
SCC_E_FILESYNTAXERR |
-27 | Chyba syntaxe souboru |
SCC_E_FILENOTEXIST |
-28 | Chyba, místní soubor neexistuje. |
SCC_E_CONNECTIONFAILURE |
-29 | Chyba: Došlo k chybě připojení. |
SCC_E_UNKNOWNERROR |
-30 | Neznámou chybu. |
SCC_E_BACKGROUNDGETINPROGRESS |
-31 | Právě probíhá operace získání na pozadí. |
Makra poskytovaná pro rychlou kontrolu
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)
Poznámky
Všechny funkce rozhraní API modulu plug-in správy zdrojového kódu (s výjimkou funkcí SccAdd, SccCheckin a SccDiff) budou úspěšné, pokud místní soubory předané jako argumenty v pracovní složce neexistují. Integrované vývojové prostředí může například vydat volání SccCheckout nebo SccUncheckout v souboru, který v pracovní složce neexistuje, ale existuje v systému správy zdrojového kódu. Toto volání by bylo úspěšné. Pouze v případě, že v pracovní složce není žádný soubor nebo v systému správy zdrojového kódu se očekává, že funkce selže.
Některé funkce, například SccAdd
a SccCheckin
, by měly konkrétně vrátit SCC_E_FILENOTEXIST
, když soubor v pracovní složce neexistuje. Očekává se, že ostatní funkce budou úspěšné, pokud pracovní soubor neexistuje, pokud funkce pracují s platným názvem souboru v systému správy zdrojového kódu.
Modul plug-in správy zdrojového kódu by neměl mít žádné předpoklady týkající se oprávnění k souboru v pracovní složce, i když modul plug-in během určité operace označil soubor jen pro čtení. Soubor v pracovní složce lze přesunout, odstranit a změnit mimo ovládací prvek modulu plug-in.