SccAdd-Funktion
Diese Funktion wird dem Quellcodeverwaltungssystem neue Dateien hinzu.
SCCRTN SccAdd(
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames,
LPCSTR lpComment,
LONG* pfOptions,
LPCMDOPTS pvOptions
);
Parameter
pvContext
[in] Die Quellcodeverwaltungs-Plug-In-Kontext Struktur.hWnd
[in] Ein Handle für das IDE-Fenster, das das Quellcodeverwaltungs-Plug-In als übergeordnetes Element für alle Dialogfelder verwenden kann, die er bereitstellt.nFiles
[in] Anzahl von Dateien ausgewählt, im aktuellen Projekt hinzugefügt werden sollen, z. B. lpFileNames im angegebenen Array.lpFileNames
[in] Array von vollqualifizierten lokalen Namen von Dateien hinzugefügt werden soll.lpComment
[in] Der zu allen Dateien zu übernehmenden Kommentar, die hinzugefügt werden.pfOptions
[in] Array Befehls Flags bereitgestellt auf einer einzelnen FILE-Basis.pvOptions
[in] Plug-in-spezifisch Optionen der Quellcodeverwaltung.
Rückgabewert
Die Quellcodeverwaltungs-Plug-In-Implementierung dieser Funktion wird erwartet, dass es sich um einen der folgenden Werte zurückgeben:
Wert |
Beschreibung |
|---|---|
SCC_OK |
Der Hinzufügens Vorgang war erfolgreich. |
SCC_E_FILEALREADYEXISTS |
Die ausgewählte Datei ist bereits in die Quellcodeverwaltung einbezogen. |
SCC_E_TYPENOTSUPPORTED |
Der Dateityp (z. B. binär) wird nicht durch das Quellcodeverwaltungssystem unterstützt. |
SCC_E_OPNOTSUPPORTED |
Das Quellcodeverwaltungssystem diesen Vorgang nicht unterstützt. |
SCC_E_ACCESSFAILURE |
Es bestand ein Problem, das das Quellcodeverwaltungssystem, wahrscheinlich aufgrund der Netzwerk- oder Konflikt bei der zugreift. Eine Wiederholung wird empfohlen. |
SCC_E_NOTAUTHORIZED |
Der Benutzer ist nicht zulässig, um diesen Vorgang auszuführen. |
SCC_E_NONSPECIFICERROR |
Unspezifischer Fehler. wird nicht ausgeführt. |
SCC_I_OPERATIONCANCELED |
Der Vorgang wurde vor Abschluss abgebrochen. |
SCC_I_RELOADFILE |
Eine Datei oder ein Projekt muss erneut geladen werden. |
SCC_E_FILENOTEXIST |
Die lokale Datei wurde nicht gefunden. |
Hinweise
Übliche fOptions werden hier ein Array, pfOptionsLONG von einer Optionsangabe pro Datei ersetzt. Dies liegt daran, dass der Dateityp aus der Datei in die Datei möglicherweise variieren.
Hinweis
Er ist ungültig, SCC_FILETYPE_TEXT und SCC_FILETYPE_BINARY Optionen für dieselbe Datei anzugeben, aber er ist gültig, keine anzugeben.Keine festgelegt SCC_FILETYPE_AUTOentspricht dem Festlegen der in diesem Fall das Quellcodeverwaltungs-Plug-In den Dateityp automatisch erkennt.
Im Folgenden finden Sie die Liste von Flags, die im pfOptions Array verwendet werden:
Option |
Wert |
Bedeutung |
|---|---|---|
SCC_FILETYPE_AUTO |
0x00 |
Das Quellcodeverwaltungs-Plug-In sollte den Dateityp erkennen. |
SCC_FILETYPE_TEXT |
0x01 |
Gibt eine ASCII-Textdatei. |
SCC_FILETYPE_BINARY |
0x02 |
Gibt einen anderen Dateityp als ASCII-Text an. |
SCC_ADD_STORELATEST |
0x04 |
Speichert nur die letzte Kopie der Datei nicht um Deltas. |
SCC_FILETYPE_TEXT_ANSI |
0x08 |
Behandelt die Datei als ANSI-Text. |
SCC_FILETYPE_UTF8 |
0x10 |
Behandelt die Datei wie Unicode-Text im Format UTF8. |
SCC_FILETYPE_UTF16LE |
0x20 |
Behandelt die Datei wie Unicode-Text im Format des Little-Endians UTF16. |
SCC_FILETYPE_UTF16BE |
0x40 |
Behandelt die Datei wie Unicode-Text im Format des Big-Endians UTF16. |