SccAdd – funkce

Článek
01/13/2024

Tato funkce přidá nové soubory do systému správy zdrojového kódu.

Syntaxe

SCCRTN SccAdd(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LPCSTR    lpComment,
   LONG*     pfOptions,
   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 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 vybraných souborů, které se mají přidat do aktuálního projektu, jak je uvedeno v lpFileNames poli

lpFileNames

[v] Pole plně kvalifikovaných místních názvů souborů, které se mají přidat.

lpComment

[v] Komentář, který se má použít pro všechny přidané soubory.

pfOptions

[v] Pole příznaků příkazů, které jsou k dispozici pro jednotlivé soubory

pvOptions

[v] Možnosti modulu plug-in správy zdrojového kódu

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	Operace přidání byla úspěšná.
SCC_E_FILEALREADYEXISTS	Vybraný soubor je již ve správě zdrojového kódu.
SCC_E_TYPENOTSUPPORTED	Systém správy zdrojového kódu nepodporuje typ souboru (například binární).
SCC_E_OPNOTSUPPORTED	Systém správy zdrojového kódu tuto operaci nepodporuje.
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_NOTAUTHORIZED	Uživatel nemůže tuto operaci provést.
SCC_E_NONSPECIFICERROR	Nespecifické selhání; přidání nebylo provedeno.
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

fOptions Obvyklé jsou zde nahrazeny polem , pfOptionss jednou LONG specifikací možností pro každý soubor. Důvodem je to, že se typ souboru může lišit od souboru po soubor.

Poznámka:

Zadání obou SCC_FILETYPE_TEXT SCC_FILETYPE_BINARY možností pro stejný soubor je neplatné, ale je platné zadat ani jedno. Nastavení ani jedno není stejné jako nastavení SCC_FILETYPE_AUTO, v takovém případě modul plug-in správy zdrojového kódu automaticky definuje typ souboru.

Níže je seznam příznaků použitých v pfOptions poli:

Možnost	Hodnota	Význam
SCC_FILETYPE_AUTO	0x00	Modul plug-in správy zdrojového kódu by měl rozpoznat typ souboru.
SCC_FILETYPE_TEXT	0x01	Označuje textový soubor ASCII.
SCC_FILETYPE_BINARY	0x02	Označuje jiný typ souboru než text ASCII.
SCC_ADD_STORELATEST	0x04	Ukládá pouze nejnovější kopii souboru, žádné rozdíly.
SCC_FILETYPE_TEXT_ANSI	0x08	Považuje soubor za text ANSI.
SCC_FILETYPE_UTF8	0x10	Považuje soubor za text Unicode ve formátu UTF8.
SCC_FILETYPE_UTF16LE	0x20	Považuje soubor za text Unicode ve formátu UTF16 Little Endian.
SCC_FILETYPE_UTF16BE	0x40	Považuje soubor za text Unicode ve formátu UTF16 Big Endian.

Viz také

Funkce rozhraní API modulu plug-in správy zdrojového kódu

Sdílet prostřednictvím