Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette fonction renomme un fichier dans le système de contrôle de code source.
Syntaxe
SCCRTN SccRename(
LPVOID pvContext,
HWND hWnd,
LPCSTR lpFileName,
LPCSTR lpNewName
);
Paramètres
pvContext
[in] Structure de contexte du plug-in de contrôle de code source.
hWnd
[in] Handle vers la fenêtre IDE que le plug-in de contrôle de code source peut utiliser comme parent pour toutes les boîtes de dialogue qu’il fournit.
lpFileName
[in] Nom de fichier complet du fichier renommé.
lpNewName
[in] Nouveau nom complet. Si le chemin d’accès au répertoire est différent, le fichier est déplacé d’un sous-répertoire à un autre.
Valeur de retour
L’implémentation du plug-in de contrôle de code source de cette fonction est censée retourner l’une des valeurs suivantes :
| Valeur | Description |
|---|---|
| SCC_OK | L’opération de changement de nom s’est terminée avec succès. |
| SCC_E_PROJNOTOPEN | Le projet n’est pas ouvert sous contrôle de code source. |
| SCC_E_FILENOTCONTROLLED | Le fichier n’est pas sous contrôle de code source. |
| SCC_E_ACCESSFAILURE | Il y a eu un problème d’accès au système de contrôle de code source, probablement en raison de problèmes de réseau ou de contention. |
| SCC_E_NOTAUTHORIZED | L’utilisateur n’est pas autorisé à effectuer cette opération. |
| SCC_E_COULDNOTCREATEPROJECT | Impossible de créer le projet dans le cadre du processus de renommage. |
| SCC_E_OPNOTPERFORMED | L’opération n’a pas été effectuée. |
| SCC_E_NONSPECIFICERROR | Une erreur non spécifiée ou générale s’est produite. |
Notes
Cette fonction peut être utilisée pour renommer un fichier ou le déplacer d’un emplacement à un autre dans le système de contrôle de code source. Le plug-in de contrôle de code source ne doit pas tenter d’accéder au fichier sur le disque. Il incombe à l’IDE de renommer le fichier local.