Udostępnij za pośrednictwem


SccCheckin, funkcja

Ta funkcja sprawdza wcześniej wyewidencjonowane pliki w systemie kontroli źródła, przechowując zmiany i tworząc nową wersję. Ta funkcja jest wywoływana za pomocą liczby i tablicy nazw plików do zaewidencjonowania.

Składnia

SCCRTN SccCheckin (
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPSTR*    lpFileNames,
   LPCSTR    lpComment,
   LONG      fOptions,
   LPCMDOPTS pvOptions
);

Parametry

pvContext

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

Hwnd

[in] Dojście do okna ŚRODOWISKA IDE, którego wtyczka SCC może używać jako elementu nadrzędnego dla dowolnych okien dialogowych, które udostępnia.

nFiles

[in] Liczba plików wybranych do zaewidencjonowania.

lpFileNames

[in] Tablica w pełni kwalifikowanych nazw ścieżek lokalnych plików do zaewidencjonowania.

lpComment

[in] Komentarz do zastosowania do każdego z zaznaczonych plików zaewidencjonowanych. Ten parametr jest taki NULL , jeśli wtyczka kontroli źródła powinna wyświetlić monit o komentarz.

Foptions

[in] Flagi poleceń: 0 lub SCC_KEEP_CHECKEDOUT.

pvOptions

[in] Opcje specyficzne dla wtyczki SCC.

Wartość zwracana

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

Wartość Opis
SCC_OK Plik został pomyślnie zaewidencjonowany.
SCC_E_FILENOTCONTROLLED Wybrany plik nie jest pod kontrolą kodu źródłowego.
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_NONSPECIFICERROR Niepowodzeń nieokreślonych. Plik nie został zaewidencjonowany.
SCC_E_NOTCHECKEDOUT Użytkownik nie wyewidencjonował pliku, więc nie może go zaewidencjonować.
SCC_E_CHECKINCONFLICT Nie można wykonać sprawdzania, ponieważ:

- Inny użytkownik zaewidencjonował przed nami i bAutoReconcile był fałszywy.

— lub —

— Nie można wykonać automatycznego scalania (na przykład gdy pliki są plikami binarnymi).
SCC_E_VERIFYMERGE Plik został automatycznie scalony, ale nie został zaewidencjonowany w oczekiwaniu na weryfikację użytkownika.
SCC_E_FIXMERGE Plik został scalony automatycznie, ale nie został zaewidencjonowany z powodu konfliktu scalania, który musi zostać rozwiązany ręcznie.
SCC_E_NOTAUTHORIZED Użytkownik nie może wykonać tej operacji.
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

Komentarz dotyczy wszystkich plików zaewidencjonowany. Argument komentarza może być ciągiem null , w tym przypadku wtyczka kontroli źródła może monitować użytkownika o ciąg komentarza dla każdego pliku.

Argument fOptions może mieć wartość flagi SCC_KEEP_CHECKEDOUT , aby wskazać intencję użytkownika do zaewidencjonowania pliku i wyewidencjonowania go ponownie.

Zobacz też