Freigeben über


SccRename-Funktion

Diese Funktion Umbenennen einer Datei im Quellcodeverwaltungssystem.

SCCRTN SccRename(
   LPVOID pvContext,
   HWND   hWnd,
   LPCSTR lpFileName,
   LPCSTR lpNewName
);

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.

  • lpFileName
    [in] Der vollqualifizierte Dateiname der Datei, die umbenannt wird.

  • lpNewName
    [in] Der vollqualifizierte neue Name. Wenn der Verzeichnispfad unterscheidet, dann hat die Datei aus einem Unterverzeichnis in einen anderen verschoben.

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 Umbenennen Vorgang erfolgreich abgeschlossen.

SCC_E_PROJNOTOPEN

Das Projekt ist nicht quellcodeverwaltung Sie unter geöffnet.

SCC_E_FILENOTCONTROLLED

Die Datei wird nicht in die Quellcodeverwaltung einbezogen.

SCC_E_ACCESSFAILURE

Es bestand ein Problem, das das Quellcodeverwaltungssystem, wahrscheinlich aufgrund der Netzwerk- oder Konflikt bei der zugreift.

SCC_E_NOTAUTHORIZED

Der Benutzer ist nicht berechtigt, um den Vorgang abzuschließen.

SCC_E_COULDNOTCREATEPROJECT

Das Projekt konnte nicht als Teil des Umbenennen Prozesses erstellt werden.

SCC_E_OPNOTPERFORMED

Der Vorgang wurde nicht ausgeführt.

SCC_E_NONSPECIFICERROR

Ein nicht angegeben oder allgemeiner Fehler ist aufgetreten.

Hinweise

Diese Funktion kann verwendet werden, um eine Datei umzubenennen oder sie von einem Speicherort auf andere im Quellcodeverwaltungssystem zu verschieben. Das Quellcodeverwaltungs-Plug-In sollten nicht versuchen, die Datei auf dem Datenträger zuzugreifen. Es liegt in der Verantwortung der IDE angezeigt, die auf lokale Datei umzubenennen.

Siehe auch

Konzepte

API-Funktionen für das Quellcodeverwaltungs-Plug-In