Funkcja SccAdd

  • Artykuł

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