SccRunScc Function

Note

This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

This function invokes the source control administration tool.

Syntax

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.

Return Value

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

Value Description
SCC_OK The source control administration tool was successfully invoked.
SCC_I_OPERATIONCANCELED The operation was cancelled.
SCC_E_INITIALIZEFAILED Failed to initialize the source control system.
SCC_E_ACCESSFAILURE There was a problem accessing the source control system, probably due to network or contention issues.
SCC_E_CONNECTIONFAILURE Failed to connect to the source control system.
SCC_E_FILENOTCONTROLLED The selected file is not under source control.
SCC_E_NONSPECIFICERROR Nonspecific failure.

Remarks

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).

See Also

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