Fonction SccRename

Article
01/13/2024

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.

Voir aussi

Fonctions d’API du plug-in de contrôle de code source

Partager via