Funkcja SccCheckout
Biorąc pod uwagę listę w pełni kwalifikowanych nazw plików, ta funkcja sprawdza je na dysku lokalnym. Komentarz dotyczy wszystkich wyewidencjonowany plików. Argument komentarza może być ciągiem null
.
Składnia
SCCRTN SccCheckout (
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* 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 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 wyewidencjonowania.
lpFileNames
[in] Tablica w pełni kwalifikowanych nazw ścieżek lokalnych plików do wyewidencjonowania.
lpComment
[in] Komentarz do zastosowania do każdego z zaznaczonych plików wyewidencjonowanych.
Foptions
[in] Flagi poleceń (zobacz Bitflags używane przez określone polecenia).
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 | Sprawdzanie zakończyło się pomyślnie. |
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_NOTAUTHORIZED | Użytkownik nie może wykonać tej operacji. |
SCC_E_NONSPECIFICERROR | Niepowodzeń nieokreślonych. Plik nie został wyewidencjonowany. |
SCC_E_ALREADYCHECKEDOUT | Użytkownik ma już wyewidencjonowany plik. |
SCC_E_FILEISLOCKED | Plik jest zablokowany, zabraniając tworzenia nowych wersji. |
SCC_E_FILEOUTEXCLUSIVE | Inny użytkownik dokonał wyłącznego wyewidencjonowania tego pliku. |
SCC_I_OPERATIONCANCELED | Operacja została anulowana przed zakończeniem. |