SccRunScc (fonction)SccRunScc Function

Cette fonction appelle l’outil d’administration de contrôle source.This function invokes the source control administration tool.

SyntaxeSyntax

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

ParamètresParameters

pvContextpvContext
[in] La structure de contexte plug-in de contrôle de code source.[in] The source control plug-in context structure.

hWndhWnd
[in] Handle vers la fenêtre de l’IDE que le plug-in de contrôle de code source peut utiliser en tant que parent pour toutes les boîtes de dialogue qu’il fournit.[in] A handle to the IDE window that the source control plug-in can use as a parent for any dialog boxes that it provides.

nFilesnFiles
[in] Nombre de fichiers spécifiés dans le lpFileNames tableau.[in] Number of files specified in the lpFileNames array.

lpFileNameslpFileNames
[in] Tableau des noms de fichier sélectionné.[in] Array of selected file names.

Valeur de retourReturn Value

L’implémentation de plug-in de contrôle de source de cette fonction est censée retourner l’une des valeurs suivantes :The source control plug-in implementation of this function is expected to return one of the following values:

ValueValue DescriptionDescription
SCC_OKSCC_OK L’outil administration de contrôle de code source a été appelé avec succès.The source control administration tool was successfully invoked.
SCC_I_OPERATIONCANCELEDSCC_I_OPERATIONCANCELED L’opération a été annulée.The operation was cancelled.
SCC_E_INITIALIZEFAILEDSCC_E_INITIALIZEFAILED Impossible d’initialiser le système de contrôle de code source.Failed to initialize the source control system.
SCC_E_ACCESSFAILURESCC_E_ACCESSFAILURE Impossible d’accéder au système de contrôle source, probablement en raison de problèmes réseau ou de contention.There was a problem accessing the source control system, probably due to network or contention issues.
SCC_E_CONNECTIONFAILURESCC_E_CONNECTIONFAILURE Impossible de se connecter au système de contrôle de code source.Failed to connect to the source control system.
SCC_E_FILENOTCONTROLLEDSCC_E_FILENOTCONTROLLED Le fichier sélectionné n’est pas sous contrôle de code source.The selected file is not under source control.
SCC_E_NONSPECIFICERRORSCC_E_NONSPECIFICERROR Erreur non spécifique.Nonspecific failure.

NotesRemarks

Cette fonction permet à l’appelant pour accéder à la gamme complète des fonctionnalités du système de contrôle de code source via un outil d’administration externe.This function allows the caller to access the full range of features of the source control system through an external administration tool. Si le système de contrôle de code source n’a aucune interface utilisateur, le plug-in de contrôle de code source peut implémenter une interface pour effectuer des fonctions d’administration nécessaires.If the source control system has no user interface, the source control plug-in can implement an interface to perform necessary administration functions.

Cette fonction est appelée avec un nombre et un tableau de noms de fichiers pour les fichiers actuellement sélectionnés.This function is called with a count and an array of file names for the currently selected files. Si l’outil d’administration prend en charge, la liste des fichiers peut servir à présélectionner des fichiers dans l’interface d’administration ; dans le cas contraire, la liste peut être ignorée.If the administration tool supports it, the list of files can be used to preselect files in the administration interface; otherwise, the list can be ignored.

Cette fonction est généralement appelée lorsque l’utilisateur sélectionne le lancer <Source Control Server > à partir de la fichier -> contrôle de code Source menu.This function is typically invoked when the user selects the Launch <Source Control Server> from the File -> Source Control menu. Cela lancer option de menu permettre être toujours désactivée ou masquée en définissant une entrée de Registre.This Launch menu option can be always disabled or even hidden by setting a registry entry. Consultez Comment : installer un plug-in de contrôle de code Source pour plus d’informations.See How to: Install a Source Control Plug-in for details. Cette fonction est appelée uniquement si SccInitialize retourne le SCC_CAP_RUNSCC bits de capacité (consultez indicateurs pour plus d’informations sur les autres bits de fonctionnalité).This function is called only if SccInitialize returns the SCC_CAP_RUNSCC capability bit (see Capability Flags for details on this and other capability bits).

Voir aussiSee Also

Fonctions d’API de plug-in de contrôle de source Source Control Plug-in API Functions
Comment : installer un plug-in de contrôle de code Source How to: Install a Source Control Plug-in
Indicateurs de capacité Capability Flags
SccInitializeSccInitialize