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.

Zobacz też