SccCheckin-Funktion

Artikel
01/13/2024

Diese Funktion überprüft zuvor ausgecheckte Dateien im Quellcodeverwaltungssystem, speichert die Änderungen und erstellt eine neue Version. Diese Funktion wird mit einer Anzahl und einem Array von Namen der dateien aufgerufen, die eingecheckt werden sollen.

Syntax

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

Parameter

pvContext

[in] Die Kontextstruktur des Quellcodeverwaltungs-Plug-Ins.

hWnd

[in] Ein Handle für das IDE-Fenster, das das SCC-Plug-In als übergeordnetes Element für alle von ihr bereitgestellten Dialogfelder verwenden kann.

nFiles

[in] Die Anzahl der ausgewählten Dateien, die eingecheckt werden sollen.

lpFileNames

[in] Array von vollqualifizierten lokalen Pfadnamen von Dateien, die eingecheckt werden sollen.

lpComment

[in] Kommentar, der auf jede der ausgewählten Dateien angewendet werden soll, die eingecheckt werden. Dieser Parameter ist NULL , wenn das Quellcodeverwaltungs-Plug-In zur Eingabe eines Kommentars aufgefordert werden soll.

Foptions

[in] Befehlskennzeichnungen, entweder 0 oder SCC_KEEP_CHECKEDOUT.

pvOptions

[in] SCC-Plug-In-spezifische Optionen.

Rückgabewert

Die Plug-In-Implementierung dieser Funktion für die Quellcodeverwaltung wird voraussichtlich einen der folgenden Werte zurückgeben:

Wert	Beschreibung
SCC_OK	Die Datei wurde erfolgreich eingecheckt.
SCC_E_FILENOTCONTROLLED	Die ausgewählte Datei befindet sich nicht unter quellcodeverwaltung.
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	Nicht spezifischer Fehler. Die Datei wurde nicht eingecheckt.
SCC_E_NOTCHECKEDOUT	Der Benutzer hat die Datei nicht ausgecheckt, kann sie daher nicht einchecken.
SCC_E_CHECKINCONFLICT	Die Überprüfung konnte nicht ausgeführt werden, weil: – Ein anderer Benutzer hat sich im Voraus eingecheckt und `bAutoReconcile` war falsch. Oder - Die automatische Zusammenführung kann nicht ausgeführt werden (z. B. wenn Dateien binär sind).
SCC_E_VERIFYMERGE	Die Datei wurde automatisch zusammengeführt, wurde aber nicht in der ausstehenden Benutzerüberprüfung eingecheckt.
SCC_E_FIXMERGE	Die Datei wurde automatisch zusammengeführt, wurde aber aufgrund eines Zusammenführungskonflikts nicht eingecheckt, der manuell aufgelöst werden muss.
SCC_E_NOTAUTHORIZED	Der Benutzer darf diesen Vorgang nicht ausführen.
SCC_I_OPERATIONCANCELED	Der Vorgang wurde vor Abschluss abgebrochen.
SCC_I_RELOADFILE	Eine Datei oder ein Projekt muss neu geladen werden.
SCC_E_FILENOTEXIST	Die lokale Datei wurde nicht gefunden.

Hinweise

Der Kommentar gilt für alle Eingecheckten Dateien. Das Kommentarargument kann eine null Zeichenfolge sein, in diesem Fall kann das Quellcodeverwaltungs-Plug-In den Benutzer zur Eingabe einer Kommentarzeichenfolge für jede Datei auffordern.

Das fOptions Argument kann einen Wert des SCC_KEEP_CHECKEDOUT Flags erhalten, um anzugeben, dass der Benutzer die Datei einchecken und erneut auschecken möchte.

Siehe auch

Plug-In-API-Funktionen der Quellcodeverwaltung

Freigeben über