Funzione SccRename
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.