This documentation is archived and is not being maintained.

SccWillCreateSccFile Function

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

This function determines whether the source control plug-in supports the creation of the MSSCCPRJ.SCC file for each of the given files.


SCCRTN SccWillCreateSccFile(
   LPVOID  pContext,
   LONG    nFiles,
   LPCSTR* lpFileNames,
   LPBOOL  pbSccFiles
);

Parameters

pContext

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

nFiles

[in] The number of file names included in the lpFileNames array as well as the length of the pbSccFiles array.

lpFileNames

[in] An array of fully qualified file names to check (array must be allocated by caller).

pbSccFiles

[in, out] Array in which to store the results.

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

Value Description

SCC_OK

Success.

SCC_E_INVALIDFILEPATH

One of the paths in the array is invalid.

SCC_E_NONSPECIFICERROR

Nonspecific failure.

This function is called with a list of files to determine if the source control plug-in provides support in the MSSCCPRJ.SCC file for each of the given files (for more information on the MSSCCPRJ.SCC file, see The MSSCCPRJ.SCC File). Source control plug-ins can declare whether they have the capability of creating MSSCCPRJ.SCC files by declaring SCC_CAP_SCCFILE during initialization. The plug-in returns TRUE or FALSE per file in the pbSccFiles array to indicate which of the given files have MSSCCPRJ.SCC support. If the plug-in returns a success code from the function, the values in the return array are honored. On failure, the array is ignored.

Show: