Freigeben über


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.

Siehe auch

Konzepte

API-Funktionen für das Quellcodeverwaltungs-Plug-In