SccDirDiff, funkcja
Ta funkcja wyświetla różnice między bieżącym katalogem lokalnym na dysku klienta a odpowiednim projektem pod kontrolą źródła.
Składnia
SCCRTN SccDirDiff(
LPVOID pContext,
HWND hWnd,
LPCSTR lpDirName,
LONG dwFlags,
LPCMDOPTS pvOptions
);
Parametry
Pcontext
[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.
Nazwa lpDirName
[in] W pełni kwalifikowana ścieżka do katalogu lokalnego, dla którego ma być wyświetlana różnica wizualna.
Dwflags
[in] Flagi poleceń (zobacz sekcję Uwagi).
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 | Katalog na dysku jest taki sam jak projekt w kontroli kodu źródłowego. |
SCC_I_FILESDIFFER | Katalog na dysku różni się od projektu w kontroli kodu źródłowego. |
SCC_I_RELOADFILE | Należy ponownie załadować plik lub projekt. |
SCC_E_FILENOTCONTROLLED | Katalog nie jest pod kontrolą kodu źródłowego. |
SCC_E_NOTAUTHORIZED | Użytkownik nie może wykonać 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_NONSPECIFICERROR SCC_E_UNKNOWNERROR |
Niepowodzeń nieokreślonych. |
SCC_E_FILENOTEXIST | Nie można odnaleźć katalogu lokalnego. |
Uwagi
Ta funkcja służy do instruowania wtyczki kontroli źródła w celu wyświetlenia użytkownikowi listy zmian w określonym katalogu. Wtyczka otwiera własne okno w wybranym formacie, aby wyświetlić różnice między katalogiem użytkownika na dysku a odpowiednim projektem pod kontrolą wersji.
Jeśli wtyczka obsługuje porównywanie katalogów w ogóle, musi obsługiwać porównanie katalogów na podstawie nazwy pliku, nawet jeśli opcje szybkiej różnicy nie są obsługiwane.
dwFlags |
Interpretacja |
---|---|
SCC_DIFF_IGNORECASE | Porównanie bez uwzględniania wielkości liter (może być używane do szybkiej różnicy lub wizualizacji). |
SCC_DIFF_IGNORESPACE | Ignoruje białe znaki (może służyć do szybkiej różnicy lub wizualizacji). |
SCC_DIFF_QD_CONTENTS | Jeśli jest obsługiwana przez wtyczkę kontroli źródła, w trybie dyskretnym porównuje katalog bajtów bajtów. |
SCC_DIFF_QD_CHECKSUM | Jeśli jest obsługiwana przez wtyczkę, dyskretnie porównuje katalog za pośrednictwem sumy kontrolnej lub, jeśli nie jest obsługiwana, powraca do SCC_DIFF_QD_CONTENTS. |
SCC_DIFF_QD_TIME | Jeśli jest obsługiwana przez wtyczkę, dyskretnie porównuje katalog za pośrednictwem znacznika czasu lub, jeśli nie jest obsługiwany, powraca do SCC_DIFF_QD_CHECKSUM lub SCC_DIFF_QD_CONTENTS. |
Uwaga
Ta funkcja używa tych samych flag poleceń co SccDiff. Jednak wtyczka kontroli źródła może nie obsługiwać operacji "szybkiej różnicy" dla katalogów.