Funzione SccRename

  • Articolo

Questa funzione rinomina un file nel sistema di controllo del codice sorgente.

Sintassi

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

Parametri

pvContext

[in] Struttura del contesto del plug-in del controllo del codice sorgente.

hWnd

[in] Handle per la finestra dell'IDE che il plug-in del controllo del codice sorgente può usare come elemento padre per qualsiasi finestra di dialogo fornita.

lpFileName

[in] Nome completo del file da rinominare.

lpNewName

[in] Nuovo nome completo. Se il percorso della directory è diverso, il file viene spostato da una sottodirectory a un'altra.

Valore restituito

L'implementazione del plug-in del controllo del codice sorgente di questa funzione dovrebbe restituire uno dei valori seguenti:

Valore Descrizione
SCC_OK Operazione di ridenominazione completata correttamente.
SCC_E_PROJNOTOPEN Il progetto non è aperto sotto il controllo del codice sorgente.
SCC_E_FILENOTCONTROLLED Il file non è sotto il controllo del codice sorgente.
SCC_E_ACCESSFAILURE Si è verificato un problema durante l'accesso al sistema di controllo del codice sorgente, probabilmente a causa di problemi di rete o contesa.
SCC_E_NOTAUTHORIZED L'utente non è autorizzato a completare questa operazione.
SCC_E_COULDNOTCREATEPROJECT Impossibile creare il progetto come parte del processo di ridenominazione.
SCC_E_OPNOTPERFORMED L'operazione non è stata eseguita.
SCC_E_NONSPECIFICERROR Si è verificato un errore generale o non specificato.

Osservazioni:

Questa funzione può essere usata per rinominare un file o spostarlo da una posizione a un'altra nel sistema di controllo del codice sorgente. Il plug-in del controllo del codice sorgente non deve tentare di accedere al file su disco. È responsabilità dell'IDE rinominare il file locale.

Vedi anche