Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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. |