Partager via


SccRename, fonction

cette fonction renomme un fichier dans le système de contrôle de code source.

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

Paramètres

  • pvContext
    [in] La structure du plug-in du contexte de contrôle de code source.

  • hWnd
    [in] Un handle de la fenêtre IDE que le plug-in contrôle de code source peut utiliser en tant que parent pour toutes les boîtes de dialogue qu'elle fournit.

  • lpFileName
    [in] Le nom de fichier qualifié complet du fichier sont renommé.

  • lpNewName
    [in] le nouveau nom qualifié complet. Si le chemin d'accès est différent, le fichier a déplacé à partir d'un sous-répertoire à un autre.

Valeur de retour

Il est recommandé que l'implémentation du plug-in du contrôle de code source de cette fonction retourne 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 contrôle de code source de sous ouvert.

SCC_E_FILENOTCONTROLLED

Le fichier n'est pas sous contrôle de code source.

SCC_E_ACCESSFAILURE

Un problème est survenu lors de l'accès au système de contrôle de code source, probablement en raison de problèmes de réseau ou de conflit.

SCC_E_NOTAUTHORIZED

L'utilisateur n'est pas autorisé à effectuer cette opération.

SCC_E_COULDNOTCREATEPROJECT

Le projet n'a pas pu être créé dans le cadre de le processus le renommant.

SCC_E_OPNOTPERFORMED

l'opération n'a pas été exécutée.

SCC_E_NONSPECIFICERROR

une erreur non spécifiée ou générale produite.

Notes

Cette fonction pour renommer un fichier ou le déplacer d'un emplacement vers un autre dans le système de contrôle de code source. Le plug-in contrôle de code source ne doit pas tenter d'accéder au fichier sur le disque. Il est de la responsabilité de l'IDE de renommer le fichier local.

Voir aussi

Concepts

Fonctions API des plug-ins de contrôle de code source