This documentation is archived and is not being maintained.

SccBackgroundGet Function

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

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

Parameters

pContext

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

nFiles

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

lpFileNames

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

NoteNote

The names must be fully qualified local filenames.

dwFlags

[in] Command flags (SCC_GET_ALL, SCC_GET_RECURSIVE).

dwBackgroundOperationID

[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:

Value Description

SCC_OK

Operation completed successfully.

SCC_E_BACKGROUNDGETINPROGRESS

A 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_OPERATIONCANCELED

Operation 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 Function.

Show: