SccBackgroundGet Function


The new home for Visual Studio documentation is Visual Studio 2017 Documentation on

The latest version of this topic can be found at SccBackgroundGet Function.

This function retrieves from source control each of the specified files with no user interaction.

SCCRTN SccBackgroundGet(  
   LPVOID  pContext,  
   LONG    nFiles,  
   LPCSTR* lpFileNames,  
   LONG    dwFlags,  
   LONG    dwBackgroundOperationID  


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

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

[in, out] Array of names of files to be retrieved.

System_CAPS_ICON_note.jpg Note

The names must be fully qualified local filenames.

[in] Command flags (SCC_GET_ALL, SCC_GET_RECURSIVE).

[in] A unique value associated with this operation.

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

SCC_OKOperation completed successfully.
SCC_E_BACKGROUNDGETINPROGRESSA background retrieval is already in progress (the source control plug-in should return this only if it does not support simultaneous batch operations).
SCC_I_OPERATIONCANCELEDOperation was canceled before being completed.

This function is always called on a thread different from the one that loaded the source control plug-in. This function is not expected to return until it is done; however, it can be called multiple times with multiple lists of files, all at the same time.

The use of the dwFlags argument is the same as the SccGet.

Source Control Plug-in API Functions