SccPopulateDirList Function
Applies to: 
Visual Studio 
Visual Studio for Mac
Note
This article applies to Visual Studio 2017. 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 determines which directories and (optionally) files are stored in source control, given a list of directories to examine.
Syntax
SCCRTN SccPopulateDirList(
LPVOID pContext,
LONG nDirs,
LPCSTR* lpDirPaths,
POPDIRLISTFUNCpfnPopulate,
LPVOID pvCallerData,
LONG fOptions
);
Parameters
pContext
[in] The source control plug-in context pointer.
nDirs
[in] Number of directory paths in the lpDirPaths array.
lpDirPaths
[in] Array of directory paths to examine.
pfnPopulate
[in] Callback function to call for each directory path and (optionally) filename in lpDirPaths (see POPDIRLISTFUNC for details).
pvCallerData
[in] Value that is to be passed unchanged to the callback function.
fOptions
[in] A combination of values that control how the directories are processed (see the "PopulateDirList flags" section of Bitflags Used by Specific Commands for possible values).
Return Value
The source control plug-in implementation of this function is expected to return one of the following values:
| Value | Description |
|---|---|
| SCC_OK | Successfully completed the operation. |
| SCC_E_UNKNOWNERROR | An error occurred. |
Remarks
Only those directories and (optionally) file names that are actually in the source control repository are passed to the callback function.