SccAddFilesFromSCC Function

 

This function adds a list of files from source control to the currently opened project.

SCCRTN SccAddFilesFromSCC(  
   LPVOID  pContext,  
   HWND    hWnd,  
   LPSTR   lpUser,  
   LPSTR   lpAuxProjPath,  
   LONG    cFiles,  
   LPCSTR* lpFilePaths,  
   LPCSTR  lpDestination,  
   LPCSTR  lpComment,  
   LPBOOL  pbResults  
);  

Parameters

pContext
[in] The source control plug-in context pointer.

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.

lpUser
[in, out] The username (up to SCC_USER_SIZE, including the null terminator).

lpAuxProjPath
[in, out] Auxiliary string identifying the project (up to SCC_PRJPATH_SIZE, including the null terminator).

cFiles
[in] Number of files given by lpFilePaths.

lpFilePaths
[in, out] Array of file names to add to the current project.

lpDestination
[in] The destination path where the files are to be written.

lpComment
[in] The comment to be applied to each of the files being added.

pbResults
[in, out] Array of flags that are set to indicate success (nonzero or TRUE) or failure (zero or FALSE) for each file (size of the array must be at least cFiles long).

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

ValueDescription
SCC_E_PROJNOTOPENProject is not open.
SCC_E_OPNOTPERFORMEDConnection is not to the same project as specified by lpAuxProjPath.
SCC_E_NOTAUTHORIZEDUser is not authorized to update the database.
SCC_E_NONSPECIFICERRORUnknown error.
SCC_I_RELOADFILEA file or project needs to be reloaded.

Source Control Plug-in API Functions

Show: