Export (0) Print
Expand All

SccDirQueryInfo Function

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

This function examines a list of fully qualified directories for their current status.


SCCRTN SccDirQueryInfo(
LPVOID  pContext,
LONG    nDirs,
LPCSTR* lpDirNames,
LPLONG  lpStatus
);

Parameters

pContext

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

nDirs

[in] The number of directories selected to be queried.

lpDirNames

[in] An array of fully qualified paths of the directories to be queried.

lpStatus

[in, out] An array structure for the source control plug-in to return the status flags (see Directory Status Code Enumerator for details).

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

Value Description

SCC_OK

The query was successful.

SCC_E_OPNOTSUPPORTED

The source code control system does not support this operation.

SCC_E_ACCESSFAILURE

There was a problem accessing the source control system, probably due to network or contention issues. A retry is recommended.

SCC_E_NONSPECIFICERROR

SCC_E_UNKNOWNERROR

Nonspecific failure.

The function fills the return array with a bitmask of bits from the SCC_DIRSTATUS family (see Directory Status Code Enumerator), one entry for each directory given. The status array is allocated by the caller.

The IDE uses this function before a directory is renamed to check whether the directory is under source control by querying whether it has a corresponding project. If the directory is not under source control, the IDE can provide the proper warning to the user.

NoteNote

If a source control plug-in chooses to not implement one or more of the status values, unimplemented bits should be set to zero.

Community Additions

ADD
Show:
© 2014 Microsoft