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.