SccCheckin – funkce

  • Článek

Tato funkce kontroluje dříve rezervované soubory do systému správy zdrojového kódu, ukládá změny a vytváří novou verzi. Tato funkce se volá s počtem a polem názvů souborů, které se mají vrátit se změnami.

Syntaxe

SCCRTN SccCheckin (
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPSTR*    lpFileNames,
   LPCSTR    lpComment,
   LONG      fOptions,
   LPCMDOPTS pvOptions
);

Parametry

pvContext

[v] Kontextová struktura modulu plug-in správy zdrojového kódu.

Hwnd

[v] Popisovač okna integrovaného vývojového prostředí(IDE), které modul plug-in SCC může použít jako nadřazený prvek pro všechna dialogová okna, která poskytuje.

nSoubory

[v] Počet vybranýchsouborůch

lpFileNames

[v] Pole plněkvalifikovanýchch

lpComment

[v] Komentář, který se má použít u každého vybraného souboru, který se má vrátit se změnami Tento parametr je NULL v případě, že by modul plug-in správy zdrojového kódu měl zobrazit výzvu k zadání komentáře.

FOptions

[v] Příznaky příkazů, buď 0, nebo SCC_KEEP_CHECKEDOUT.

pvOptions

[v] Možnosti specifické pro modul plug-in SCC.

Vrácená hodnota

Očekává se, že implementace modulu plug-in správy zdrojového kódu této funkce vrátí jednu z následujících hodnot:

Hodnota Popis
SCC_OK Soubor byl úspěšně vrácen se změnami.
SCC_E_FILENOTCONTROLLED Vybraný soubor není pod správou zdrojového kódu.
SCC_E_ACCESSFAILURE 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_NONSPECIFICERROR Nespecifické selhání. Soubor nebyl vrácen se změnami.
SCC_E_NOTCHECKEDOUT Uživatel soubor nezaškrtl, takže ho nemůže vrátit se změnami.
SCC_E_CHECKINCONFLICT Vrácení se změnami nebylo možné provést, protože:

- Jiný uživatel se přihlásil dopředu a bAutoReconcile byl nepravdivý.

nebo

– Automatické sloučení nelze provést (například pokud jsou soubory binární).
SCC_E_VERIFYMERGE Soubor se automaticky sloučil, ale nebyl vrácen se změnami čekající na ověření uživatele.
SCC_E_FIXMERGE 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_NOTAUTHORIZED Uživatel nemůže tuto operaci provést.
SCC_I_OPERATIONCANCELED Operace byla zrušena před dokončením.
SCC_I_RELOADFILE Soubor nebo projekt je potřeba znovu načíst.
SCC_E_FILENOTEXIST Místní soubor nebyl nalezen.

Poznámky

Komentář platí pro všechny soubory, které jsou vráceny se změnami. Argument komentáře může být null řetězec, v takovém případě může modul plug-in správy zdrojového kódu vyzvat uživatele k zadání řetězce komentáře pro každý soubor.

Argument fOptions může mít hodnotu příznaku SCC_KEEP_CHECKEDOUT , který označuje záměr uživatele vrátit soubor se změnami a znovu ho rezervovat.

Viz také