SccDiff-Funktion
Diese Funktion wird (oder optional) für Überprüfungen nur die Unterschiede zwischen der aktuellen Datei (auf dem lokalen Datenträger) und seiner zuletzt eingecheckten Version im Quellcodeverwaltungssystem an.
SCCRTN SccDiff(
LPVOID pvContext,
HWND hWnd,
LPCSTR lpFileName,
LONG fOptions,
LPCMDOPTS pvOptions
);
Parameter
pvContext
[in] Die Quellcodeverwaltungs-Plug-In-Kontext Struktur.hWnd
[in] Ein Handle für das IDE-Fenster, das das Quellcodeverwaltungs-Plug-In als übergeordnetes Element für alle Dialogfelder verwenden kann, die er bereitstellt.lpFileName
[in] Name der Datei, für die die Differenz angefordert wird.fOptions
[in] Befehl Flags. Weitere Informationen finden Sie in den Hinweisen.pvOptions
[in] Plug-in-spezifisch Optionen der Quellcodeverwaltung.
Rückgabewert
Die Quellcodeverwaltungs-Plug-In-Implementierung dieser Funktion wird erwartet, dass es sich um einen der folgenden Werte zurückgeben:
Wert |
Beschreibung |
|---|---|
SCC_OK |
Die Arbeitskopien- und Serverversion sind identisch. |
SCC_I_FILESDIFFERS |
Die Arbeitskopie unterscheidet sich von der Version in der Quellcodeverwaltung. |
SCC_I_RELOADFILE |
Eine Datei oder ein Projekt muss erneut geladen werden. |
SCC_E_FILENOTCONTROLLED |
Die Datei wird nicht in die Quellcodeverwaltung einbezogen. |
SCC_E_NOTAUTHORIZED |
Der Benutzer ist nicht zulässig, um diesen Vorgang auszuführen. |
SCC_E_ACCESSFAILURE |
Es bestand ein Problem, das das Quellcodeverwaltungssystem, wahrscheinlich aufgrund der Netzwerk- oder Konflikt bei der zugreift. Eine Wiederholung wird empfohlen. |
SCC_E_NONSPECIFICERROR |
Unspezifischer Fehler. Differenz der Datei konnte nicht abgerufen. |
SCC_E_FILENOTEXIST |
Die lokale Datei wurde nicht gefunden. |
Hinweise
Diese Funktion dient zwei Zwecken. Standardmäßig wird eine Liste von Änderungen an einer Datei an. Das Quellcodeverwaltungs-Plug-In öffnet ein eigenes Fenster, in die es Format auswählen, um die Unterschiede zwischen der Datei des Benutzers auf dem Datenträger und der neuesten Version der Datei unter Quellcodeverwaltung anzuzeigen.
Alternativ kann die IDE muss lediglich bestimmen, ob eine Datei geändert hat. Beispielsweise muss sich die IDE bestimmen, ob es sicher ist, eine Datei auszuchecken, ohne den Benutzer zu informieren. In diesem Fall übergibt die IDE in das SCC_DIFF_CONTENTS-Flag. Das Quellcodeverwaltungs-Plug-In muss die Datei auf dem Datenträger von Byte, Byte, für den die Quellcodeverwaltung unterliegende Dateien überprüfen und einen Wert zurückgeben, der angibt, ob die beiden Dateien verschieden sind, ohne alle vom Benutzer angezeigt werden soll.
Als Leistungsoptimierung verwendet das Quellcodeverwaltungs-Plug-In möglicherweise eine Alternative auf einen Zeitstempel oder eine Prüfsumme anstelle des Vergleichs auf Byteebene, der für durch SCC_DIFF_CONTENTSaufgerufen wird: Diese Formen des Vergleichs sind deutlich schneller, aber weniger zuverlässig. Nicht alle eventuell Quellcodeverwaltungssysteme unterstützen diese alternativen Vergleichsmethoden, und das Plug-In muss möglicherweise zurück in ein Vergleich Inhalts ab. Alle steckverbindungen Quellcodeverwaltung müssen mindestens einen Vergleich Inhalt unterstützen.
Hinweis
Die Flags für den schnellen Unterschied schließen sich gegenseitig aus.Es ist zulässig, keine Flags zu übergeben, ist jedoch ungültig, gleichzeitig zu übergebenden größer als eins.SCC_DIFF_QUICK_DIFF, das eine Maske ist, die alle Flags kombiniert, kann verwendet werden, um zu testen, aber es sollte nie als Parameter übergeben werden.
fOption |
Bedeutung |
|---|---|
SCC_DIFF_IGNORECASE |
Vergleich ohne Berücksichtigung der Groß- und Kleinschreibung (kann zur schnellen oder visuellen unterschied verwendet werden). |
SCC_DIFF_IGNORESPACE |
Ignoriert Leerzeichen (kann für den schnellen oder visuellen unterschied verwendet werden). |
SCC_DIFF_QD_CONTENTS |
Vergleicht die Datei automatisch von Byte, Byte. |
SCC_DIFF_QD_CHECKSUM |
Vergleicht automatisch die Datei über eine Prüfsumme, falls unterstützt. Wenn Sie nicht unterstützt werden, schlägt auf einem Vergleich von Inhalt. |
SCC_DIFF_QD_TIME |
Vergleicht automatisch die Datei über dessen Zeitstempel, falls unterstützt. Wenn Sie nicht unterstützt werden, schlägt auf einem Vergleich von Inhalt. |