SccRunScc – funkce
Tato funkce vyvolá nástroj pro správu správy zdrojového kódu.
Syntaxe
SCCRTN SccRunScc(
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames
);
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 správy zdrojového kódu může použít jako nadřazený prvek pro všechna dialogová okna, která poskytuje.
nSoubory
[v] Počet souborů zadaných lpFileNames v poli
lpFileNames
[v] Pole vybraných názvů souborů
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 | Nástroj pro správu správy zdrojového kódu byl úspěšně vyvolán. |
| SCC_I_OPERATIONCANCELED | Operace byla zrušena. |
| SCC_E_INITIALIZEFAILED | Inicializace systému správy zdrojového kódu se nezdařila. |
| 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í. |
| SCC_E_CONNECTIONFAILURE | Připojení k systému správy zdrojového kódu se nezdařilo. |
| SCC_E_FILENOTCONTROLLED | Vybraný soubor není pod správou zdrojového kódu. |
| SCC_E_NONSPECIFICERROR | Nespecifické selhání. |
Poznámky
Tato funkce umožňuje volajícímu přístup k celé řadě funkcí systému správy zdrojového kódu prostřednictvím externího nástroje pro správu. Pokud systém správy zdrojového kódu nemá žádné uživatelské rozhraní, modul plug-in správy zdrojového kódu může implementovat rozhraní pro provádění nezbytných funkcí správy.
Tato funkce se volá s počtem a polem názvů souborů pro aktuálně vybrané soubory. Pokud ho nástroj pro správu podporuje, lze seznam souborů použít k předběžnému výběru souborů v rozhraní pro správu; v opačném případě lze seznam ignorovat.
Tato funkce se obvykle vyvolá, když uživatel vybere server pro spuštění <správy> zdrojového kódu z nabídky File ->Source Control . Tuto možnost nabídky Spustit lze vždy zakázat nebo dokonce skrýt nastavením položky registru. Podrobnosti najdete v tématu Postupy: Instalace modulu plug-in správy zdrojového kódu. Tato funkce se volá pouze v případě, že SccInitialize vrátí SCC_CAP_RUNSCC bit schopností (podrobnosti o těchto a dalších bitech schopností najdete v části Příznaky schopností).