QUERYCHANGESFUNC

Note

This article applies to Visual Studio 2015. 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 is a callback function used by the SccQueryChanges operation to enumerate a collection of file names and determine each file's status.

The SccQueryChanges function is given a list of files and a pointer to the QUERYCHANGESFUNC callback. The source control plug-in enumerates over the given list and provides status (via this callback) for each file in the list.

Signature

typedef BOOL (*QUERYCHANGESFUNC)(  
   LPVOID pvCallerData,  
   QUERYCHANGESDATA * pChangesData  
);  

Parameters

pvCallerData
[in] The pvCallerData parameter passed by the caller (the IDE) to SccQueryChanges. The source control plug-in should make no assumptions about the contents of this value.

pChangesData
[in] Pointer to a QUERYCHANGESDATA Structure structure describing the changes to a file.

Return Value

The IDE returns an appropriate error code:

Value	Description
SCC_OK	Continue processing.
SCC_I_OPERATIONCANCELED	Stop processing.
SCC_E_xxx	Any appropriate SCC error should stop processing.

QUERYCHANGESDATA Structure

The structure passed in for each file looks like the following:

struct QUERYCHANGESDATA_A  
{  
    DWORD  dwSize;  
    LPCSTR lpFileName;  
    DWORD  dwChangeType;  
    LPCSTR lpLatestName;  
};  
  
typedef struct QUERYCHANGESDATA_A QUERYCHANGESDATA;  
  
struct QUERYCHANGESDATA_W  
{  
    DWORD   dwSize;  
    LPCWSTR lpFileName;  
    DWORD   dwChangeType;  
    LPCWSTR lpLatestName;  
};  

dwSize
Size of this structure (in bytes).

lpFileName
The original file name for this item.

dwChangeType
Code indicating status of the file:

Code	Description
SCC_CHANGE_UNKNOWN	Cannot tell what has changed.
SCC_CHANGE_UNCHANGED	No name changes for this file.
SCC_CHANGE_DIFFERENT	File with a different identity, but the same name exists in the database.
SCC_CHANGE_NONEXISTENT	File does not exist either in the database or locally.
SCC_CHANGE_DATABASE_DELETED	File deleted in the database.
SCC_CHANGE_LOCAL_DELETED	File deleted locally but the file still exists in the database. If this cannot be determined, return SCC_CHANGE_DATABASE_ADDED.
SCC_CHANGE_DATABASE_ADDED	File added to the database but does not exist locally.
SCC_CHANGE_LOCAL_ADDED	File does not exist in database and is a new local file.
SCC_CHANGE_RENAMED_TO	File renamed or moved in the database as lpLatestName.
SCC_CHANGE_RENAMED_FROM	File renamed or moved in the database from lpLatestName; if this is too expensive to track, return a different flag, such as SCC_CHANGE_DATABASE_ADDED.

lpLatestName
The current file name for this item.

See Also

Callback Functions Implemented by the IDE
SccQueryChanges
Error Codes