SccRunScc Function

 

For the latest documentation on Visual Studio 2017 RC, see Visual Studio 2017 RC Documentation.

This function invokes the source control administration tool.

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

Parameters

pvContext
[in] The source control plug-in context structure.

hWnd
[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.

nFiles
[in] Number of files specified in the lpFileNames array.

lpFileNames
[in] Array of selected file names.

The source control plug-in implementation of this function is expected to return one of the following values:

ValueDescription
SCC_OKThe source control administration tool was successfully invoked.
SCC_I_OPERATIONCANCELEDThe operation was cancelled.
SCC_E_INITIALIZEFAILEDFailed to initialize the source control system.
SCC_E_ACCESSFAILUREThere was a problem accessing the source control system, probably due to network or contention issues.
SCC_E_CONNECTIONFAILUREFailed to connect to the source control system.
SCC_E_FILENOTCONTROLLEDThe selected file is not under source control.
SCC_E_NONSPECIFICERRORNonspecific failure.

This function allows the caller to access the full range of features of the source control system through an external administration tool. If the source control system has no user interface, the source control plug-in can implement an interface to perform necessary administration functions.

This function is called with a count and an array of file names for the currently selected files. 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.

This function is typically invoked when the user selects the Launch <Source Control Server> from the File -> Source Control menu. This Launch menu option can be always disabled or even hidden by setting a registry entry. See How to: Install a Source Control Plug-in for details. 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).

Source Control Plug-in API Functions
How to: Install a Source Control Plug-in
Capability Flags
SccInitialize

Show: