Freigeben über

SccAdd-Funktion

  • Artikel

Diese Funktion fügt dem Quellcodeverwaltungssystem neue Dateien hinzu.

Syntax

SCCRTN SccAdd(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LPCSTR    lpComment,
   LONG*     pfOptions,
   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 dateien, die dem aktuellen Projekt hinzugefügt werden sollen, wie im lpFileNames Array angegeben.

lpFileNames

[in] Array von vollqualifizierten lokalen Namen von Dateien, die hinzugefügt werden sollen.

lpComment

[in] Der Kommentar, der auf alle hinzugefügten Dateien angewendet werden soll.

pfOptions

[in] Array von Befehlskennzeichnungen, die pro Datei bereitgestellt 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 Der Vorgang zum Hinzufügen war erfolgreich.
SCC_E_FILEALREADYEXISTS Die ausgewählte Datei befindet sich bereits unter der Quellcodeverwaltung.
SCC_E_TYPENOTSUPPORTED Der Dateityp (z. B. binär) wird vom Quellcodeverwaltungssystem nicht unterstützt.
SCC_E_OPNOTSUPPORTED Das Quellcodeverwaltungssystem unterstützt diesen Vorgang nicht.
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; nicht ausgeführt.
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

Die üblichen fOptions werden hier durch ein Array ersetzt, pfOptionsmit einer LONG Option Spezifikation pro Datei. Dies liegt daran, dass der Dateityp von Datei zu Datei variieren kann.

Hinweis

Es ist ungültig, beide Optionen SCC_FILETYPE_TEXT und SCC_FILETYPE_BINARY Optionen für dieselbe Datei anzugeben, aber sie ist gültig, um keines anzugeben. Die Einstellung ist nicht identisch mit der Einstellung SCC_FILETYPE_AUTO. In diesem Fall schneidet das Plug-In für die Quellcodeverwaltung den Dateityp automatisch ab.

Nachfolgend finden Sie die Liste der flags, die pfOptions im Array verwendet werden:

Option Wert Bedeutung
SCC_FILETYPE_AUTO 0x00 Das Quellcodeverwaltungs-Plug-In sollte den Dateityp erkennen.
SCC_FILETYPE_TEXT 0x01 Zeigt eine ASCII-Textdatei an.
SCC_FILETYPE_BINARY 0x02 Gibt einen anderen Dateityp als ASCII-Text an.
SCC_ADD_STORELATEST 0x04 Speichert nur die neueste Kopie der Datei, keine Deltas.
SCC_FILETYPE_TEXT_ANSI 0x08 Behandelt die Datei als ANSI-Text.
SCC_FILETYPE_UTF8 0x10 Behandelt die Datei als Unicode-Text im UTF8-Format.
SCC_FILETYPE_UTF16LE 0x20 Behandelt die Datei als Unicode-Text im UTF16 Little Endian-Format.
SCC_FILETYPE_UTF16BE 0x40 Behandelt die Datei als Unicode-Text im UTF16 Big Endian-Format.

Siehe auch