SccAdd – funkce

  • Článek

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_TEXTSCC_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é