SccDirDiff-Funktion
Diese Funktion zeigt die Unterschiede zwischen dem aktuellen lokalen Verzeichnis auf dem Clientdatenträger und dem entsprechenden Projekt unter Quellcodeverwaltung an.
Syntax
SCCRTN SccDirDiff(
LPVOID pContext,
HWND hWnd,
LPCSTR lpDirName,
LONG dwFlags,
LPCMDOPTS pvOptions
);
Parameter
pContext
[in] Die Kontextstruktur des Quellcodeverwaltungs-Plug-Ins.
hWnd
[in] Ein Handle für das IDE-Fenster, das das Quellcodeverwaltungs-Plug-In als übergeordnetes Element für alle von ihr bereitgestellten Dialogfelder verwenden kann.
lpDirName
[in] Vollqualifizierter Pfad zum lokalen Verzeichnis, für das ein visueller Unterschied angezeigt werden soll.
dwFlags
[in] Befehlskennzeichnungen (siehe Abschnitt "Hinweise").
pvOptions
[in] Plug-In-spezifische Optionen für die Quellcodeverwaltung.
Rückgabewert
Die Plug-In-Implementierung dieser Funktion für die Quellcodeverwaltung wird voraussichtlich einen der folgenden Werte zurückgeben:
Wert | Beschreibung |
---|---|
SCC_OK | Das Verzeichnis auf dem Datenträger entspricht dem Projekt in der Quellcodeverwaltung. |
SCC_I_FILESDIFFER | Das Verzeichnis auf dem Datenträger unterscheidet sich vom Projekt in der Quellcodeverwaltung. |
SCC_I_RELOADFILE | Eine Datei oder ein Projekt muss neu geladen werden. |
SCC_E_FILENOTCONTROLLED | Das Verzeichnis befindet sich nicht unter quellcodeverwaltung. |
SCC_E_NOTAUTHORIZED | Der Benutzer darf diesen Vorgang nicht ausführen. |
SCC_E_ACCESSFAILURE | Es gab ein Problem beim Zugriff auf das Quellcodeverwaltungssystem, wahrscheinlich aufgrund von Netzwerk- oder Inhaltsproblemen. Es wird ein Wiederholungsversuche empfohlen. |
SCC_E_NONSPECIFICERROR SCC_E_UNKNOWNERROR |
Nicht spezifischer Fehler. |
SCC_E_FILENOTEXIST | Das lokale Verzeichnis wurde nicht gefunden. |
Hinweise
Diese Funktion wird verwendet, um das Quellcodeverwaltungs-Plug-In anzuweisen, dem Benutzer eine Liste der Änderungen an einem angegebenen Verzeichnis anzuzeigen. Das Plug-In öffnet ein eigenes Fenster in einem Format seiner Wahl, um die Unterschiede zwischen dem Verzeichnis des Benutzers auf dem Datenträger und dem entsprechenden Projekt unter Versionssteuerung anzuzeigen.
Wenn ein Plug-In den Vergleich von Verzeichnissen überhaupt unterstützt, muss es den Vergleich von Verzeichnissen auf Dateinamebasis unterstützen, auch wenn die Optionen für "quick-diff" nicht unterstützt werden.
dwFlags |
Interpretation |
---|---|
SCC_DIFF_IGNORECASE | Vergleich zwischen Groß-/Kleinschreibung (kann für schnelles Diff oder visuelles Element verwendet werden). |
SCC_DIFF_IGNORESPACE | Ignoriert Leerzeichen (kann für Quick-Diff oder visuelle Elemente verwendet werden). |
SCC_DIFF_QD_CONTENTS | Wenn das Quellcodeverwaltungs-Plug-In unterstützt wird, vergleicht das Verzeichnis im Hintergrund byte-Byte.If supported by the source control plug-in, silently compares the directory, byte byte. |
SCC_DIFF_QD_CHECKSUM | Wenn das Plug-In unterstützt wird, vergleicht das Verzeichnis im Hintergrund über eine Prüfsumme oder falls nicht unterstützt, wird auf SCC_DIFF_QD_CONTENTS zurückgegriffen. |
SCC_DIFF_QD_TIME | Wenn das Plug-In unterstützt wird, vergleicht das Verzeichnis im Hintergrund über den Zeitstempel oder falls nicht unterstützt, wird das Verzeichnis wieder auf SCC_DIFF_QD_CHECKSUM oder SCC_DIFF_QD_CONTENTS zurückgegriffen. |
Hinweis
Diese Funktion verwendet dieselben Befehlskennzeichnungen wie der SccDiff. Ein Quellcodeverwaltungs-Plug-In kann jedoch auswählen, dass der "Quick-Diff"-Vorgang für Verzeichnisse nicht unterstützt wird.