Fonction SccRunScc

  • Article

Cette fonction appelle l’outil d’administration du contrôle de code source.

Syntaxe

SCCRTN SccRunScc(
   LPVOID  pvContext,
   HWND    hWnd,
   LONG    nFiles,
   LPCSTR* lpFileNames
);

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.

nFiles

[in] Nombre de fichiers spécifiés dans le lpFileNames tableau.

lpFileNames

[in] Tableau de noms de fichiers sélectionnés.

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’outil d’administration du contrôle de code source a été appelé avec succès.
SCC_I_OPERATIONCANCELED L'opération a été annulée.
SCC_E_INITIALIZEFAILED Échec de l’initialisation du système de 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_CONNECTIONFAILURE Échec de la connexion au système de contrôle de code source.
SCC_E_FILENOTCONTROLLED Le fichier sélectionné n’est pas sous contrôle de code source.
SCC_E_NONSPECIFICERROR Échec non spécifique.

Notes

Cette fonction permet à l’appelant d’accéder à la gamme complète de fonctionnalités du système de contrôle de code source via un outil d’administration externe. Si le système de contrôle de code source n’a pas d’interface utilisateur, le plug-in de contrôle de code source peut implémenter une interface pour effectuer les fonctions d’administration nécessaires.

Cette fonction est appelée avec un nombre et un tableau de noms de fichiers pour les fichiers actuellement sélectionnés. Si l’outil d’administration le prend en charge, la liste des fichiers peut être utilisée pour préélectionner les fichiers dans l’interface d’administration ; sinon, la liste peut être ignorée.

Cette fonction est généralement appelée lorsque l’utilisateur sélectionne le serveur> de contrôle de code source de lancement <dans le menu Fichier ->Contrôle de code source. Cette option de menu Lancer peut toujours être désactivée ou même masquée en définissant une entrée de Registre. Découvrez comment : installer un plug-in de contrôle de code source pour plus d’informations. Cette fonction est appelée uniquement si SccInitialize retourne le SCC_CAP_RUNSCC bit de fonctionnalité (consultez les indicateurs de fonctionnalité pour plus d’informations sur cette fonctionnalité et d’autres bits de fonctionnalité).

Voir aussi