SccHistory-Funktion

  • Artikel

Diese Funktion zeigt den Verlauf der angegebenen Dateien an.

Syntax

SCCRTN SccHistory(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LONG      fOptions,
   LPCMDOPTS pvOptions
);

Parameter

pvContext

[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.

nFiles

[in] Die Anzahl der im lpFileName Array angegebenen Dateien.

lpFileName

[in] Array von vollqualifizierten Namen von Dateien.

fOptions

[in] Befehlskennzeichnungen (derzeit nicht verwendet).

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 Der Versionsverlauf wurde erfolgreich abgerufen.
SCC_I_RELOADFILE Das Quellcodeverwaltungssystem hat die Datei tatsächlich auf dem Datenträger geändert, während der Verlauf abgerufen wird (z. B. durch Abrufen einer alten Version davon), sodass die IDE diese Datei erneut laden sollte.
SCC_E_FILENOTCONTROLLED Die Datei befindet sich nicht unter der Quellcodeverwaltung.
SCC_E_OPNOTSUPPORTED Das Quellcodeverwaltungssystem unterstützt diesen Vorgang nicht.
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_PROJNOTOPEN Das Projekt wurde nicht geöffnet.
SCC_E_NONSPECIFICERROR Nicht spezifischer Fehler. Der Dateiverlauf konnte nicht abgerufen werden.

Hinweise

Das Quellcodeverwaltungs-Plug-In kann ein eigenes Dialogfeld anzeigen, um den Verlauf jeder Datei mithilfe hWnd des übergeordneten Fensters anzuzeigen. Alternativ kann die optionale Textausgaberückruffunktion verwendet werden, die für SccOpenProject bereitgestellt wird, wenn sie unterstützt wird.

Beachten Sie, dass sich die geprüfte Datei unter bestimmten Umständen während der Ausführung dieses Aufrufs ändern kann. Beispielsweise bietet der Visual Source Tresor Verlaufsbefehl dem Benutzer die Möglichkeit, eine alte Version der Datei zu erhalten. In einem solchen Fall wird das Quellcodeverwaltungs-Plug-In zurückgegeben SCC_I_RELOAD , um die IDE zu warnen, dass sie die Datei erneut laden muss.

Hinweis

Wenn das Quellcodeverwaltungs-Plug-In diese Funktion für ein Array von Dateien nicht unterstützt, kann nur der Dateiverlauf für die erste Datei angezeigt werden.

Siehe auch