SccCheckout-Funktion
Aufgrund einer Liste vollqualifizierter Dateinamen überprüft diese Funktion sie auf dem lokalen Laufwerk. Der Kommentar gilt für alle Dateien, die ausgecheckt werden. Das Kommentarargument kann eine null
Zeichenfolge sein.
Syntax
SCCRTN SccCheckout (
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* 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 Quellcodeverwaltungs-Plug-In als übergeordnetes Element für alle von ihr bereitgestellten Dialogfelder verwenden kann.
nFiles
[in] Die Anzahl der ausgewählten Dateien, die ausgecheckt werden sollen.
lpFileNames
[in] Array von vollqualifizierten lokalen Pfadnamen von Dateien, die ausgecheckt werden sollen.
lpComment
[in] Kommentar, der auf die ausgewählten Dateien angewendet werden soll, die ausgecheckt werden.
Foptions
[in] Befehlskennzeichnungen (siehe Bitflags, die von bestimmten Befehlen verwendet werden).
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 | Check out war erfolgreich. |
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_NOTAUTHORIZED | Der Benutzer darf diesen Vorgang nicht ausführen. |
SCC_E_NONSPECIFICERROR | Nicht spezifischer Fehler. Die Datei wurde nicht ausgecheckt. |
SCC_E_ALREADYCHECKEDOUT | Der Benutzer hat die Datei bereits ausgecheckt. |
SCC_E_FILEISLOCKED | Die Datei ist gesperrt und verbietet die Erstellung neuer Versionen. |
SCC_E_FILEOUTEXCLUSIVE | Ein anderer Benutzer hat ein exklusives Auschecken für diese Datei durchgeführt. |
SCC_I_OPERATIONCANCELED | Der Vorgang wurde vor Abschluss abgebrochen. |