Funkcja SccAdd

Ta funkcja dodaje nowe pliki do systemu kontroli źródła.

Składnia

SCCRTN SccAdd(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LPCSTR    lpComment,
   LONG*     pfOptions,
   LPCMDOPTS pvOptions
);

Parametry

pvContext

[in] Struktura kontekstu wtyczki kontroli źródła.

Hwnd

[in] Dojście do okna środowiska IDE, którego wtyczka kontroli źródła może używać jako elementu nadrzędnego dla wszystkich okien dialogowych, które udostępnia.

nFiles

[in] Liczba plików wybranych do dodania do bieżącego projektu, jak podano w tablicy lpFileNames .

lpFileNames

[in] Tablica w pełni kwalifikowanych nazw lokalnych plików do dodania.

lpComment

[in] Komentarz, który ma zostać zastosowany do wszystkich dodawanych plików.

pfOptions

[in] Tablica flag poleceń podana dla poszczególnych plików.

pvOptions

[in] Opcje specyficzne dla wtyczki kontroli źródła.

Wartość zwracana

Implementacja wtyczki kontroli źródła tej funkcji powinna zwrócić jedną z następujących wartości:

Wartość	Opis
SCC_OK	Operacja dodawania zakończyła się pomyślnie.
SCC_E_FILEALREADYEXISTS	Wybrany plik jest już pod kontrolą źródła.
SCC_E_TYPENOTSUPPORTED	Typ pliku (na przykład binarny) nie jest obsługiwany przez system kontroli źródła.
SCC_E_OPNOTSUPPORTED	System kontroli źródła nie obsługuje tej operacji.
SCC_E_ACCESSFAILURE	Wystąpił problem podczas uzyskiwania dostępu do systemu kontroli źródła, prawdopodobnie z powodu problemów z siecią lub rywalizacją. Zalecane jest ponowienie próby.
SCC_E_NOTAUTHORIZED	Użytkownik nie może wykonać tej operacji.
SCC_E_NONSPECIFICERROR	Niepowodzeń nieokreślonych; dodawanie nie zostało wykonane.
SCC_I_OPERATIONCANCELED	Operacja została anulowana przed zakończeniem.
SCC_I_RELOADFILE	Należy ponownie załadować plik lub projekt.
SCC_E_FILENOTEXIST	Nie można odnaleźć pliku lokalnego.

Uwagi

fOptions Zwykle są tu zastępowane przez tablicę , pfOptionsz jedną LONG specyfikacją opcji na plik. Jest to spowodowane tym, że typ pliku może się różnić w zależności od pliku do pliku.

Uwaga

Nie można określić obu tych opcji i SCC_FILETYPE_TEXT SCC_FILETYPE_BINARY dla tego samego pliku, ale jest on prawidłowy do określenia żadnego z tych plików. Ustawienie ani nie jest takie samo jak ustawienie SCC_FILETYPE_AUTO, w tym przypadku wtyczka kontroli źródła automatycznie wykrywa typ pliku.

Poniżej znajduje się lista flag używanych w tablicy pfOptions :

Opcja	Wartość	Znaczenie
SCC_FILETYPE_AUTO	0x00	Wtyczka kontroli źródła powinna wykryć typ pliku.
SCC_FILETYPE_TEXT	0x01	Wskazuje plik tekstowy ASCII.
SCC_FILETYPE_BINARY	0x02	Wskazuje typ pliku inny niż tekst ASCII.
SCC_ADD_STORELATEST	0x04	Przechowuje tylko najnowszą kopię pliku, bez różnic.
SCC_FILETYPE_TEXT_ANSI	0x08	Traktuje plik jako tekst ANSI.
SCC_FILETYPE_UTF8	0x10	Traktuje plik jako tekst Unicode w formacie UTF8.
SCC_FILETYPE_UTF16LE	0x20	Traktuje plik jako tekst Unicode w formacie UTF16 Little Endian.
SCC_FILETYPE_UTF16BE	0x40	Traktuje plik jako tekst Unicode w formacie UTF16 Big Endian.

Zobacz też

• Funkcje interfejsu API wtyczki kontroli źródła