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. |