Freigeben über

SccRunScc-Funktion

  • Artikel

Diese Funktion ruft das Verwaltungstool für die Quellcodeverwaltung auf.

Syntax

SCCRTN SccRunScc(
   LPVOID  pvContext,
   HWND    hWnd,
   LONG    nFiles,
   LPCSTR* lpFileNames
);

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 lpFileNames Array angegebenen Dateien.

lpFileNames

[in] Array ausgewählter Dateinamen.

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 Verwaltungstool für die Quellcodeverwaltung wurde erfolgreich aufgerufen.
SCC_I_OPERATIONCANCELED Der Vorgang wurde abgebrochen.
SCC_E_INITIALIZEFAILED Fehler beim Initialisieren des Quellcodeverwaltungssystems.
SCC_E_ACCESSFAILURE Es gab ein Problem beim Zugriff auf das Quellcodeverwaltungssystem, wahrscheinlich aufgrund von Netzwerk- oder Inhaltsproblemen.
SCC_E_CONNECTIONFAILURE Fehler beim Herstellen einer Verbindung mit dem Quellcodeverwaltungssystem.
SCC_E_FILENOTCONTROLLED Die ausgewählte Datei befindet sich nicht unter der Quellcodeverwaltung.
SCC_E_NONSPECIFICERROR Nicht spezifischer Fehler.

Hinweise

Mit dieser Funktion kann der Aufrufer über ein externes Verwaltungstool auf den gesamten Funktionsumfang des Quellcodeverwaltungssystems zugreifen. Wenn das Quellcodeverwaltungssystem über keine Benutzeroberfläche verfügt, kann das Quellcodeverwaltungs-Plug-In eine Schnittstelle implementieren, um erforderliche Verwaltungsfunktionen auszuführen.

Diese Funktion wird mit einer Anzahl und einem Array von Dateinamen für die aktuell ausgewählten Dateien aufgerufen. Wenn das Verwaltungstool sie unterstützt, kann die Liste der Dateien verwendet werden, um Dateien in der Verwaltungsschnittstelle vorzuwählen; andernfalls kann die Liste ignoriert werden.

Diese Funktion wird in der Regel aufgerufen, wenn der Benutzer den <Quellcodeverwaltungsserver> aus dem Menü "Datei ->Quellcodeverwaltung" auswählt. Diese Menüoption "Start" kann immer deaktiviert oder sogar ausgeblendet werden, indem Sie einen Registrierungseintrag festlegen. Weitere Informationen finden Sie unter How to: Install a Source Control Plug-In . Diese Funktion wird nur aufgerufen, wenn SccInitialize das SCC_CAP_RUNSCC Funktionsbit zurückgibt (details zu diesem und anderen Funktionsbits finden Sie unter Funktionskennzeichnungen ).

Siehe auch