Callback functions implemented by the IDE
To make integration with the integrated development environment (IDE) as seamless as possible and to provide a unified end-user experience, the source control plug-in can use callback functions that are implemented by the IDE. The plug-in can call these functions at appropriate times during a source control operation to pass information to the IDE; the IDE can then display this information as embedded elements in its native UI. The user has a less fragmented experience in this scenario than if the plug-in employed its own UI.
The required header file is scc.h. The default location is \Program Files\VSIP 8.0\EnvSDK\common\inc\. It is also in the VSIP folder that has the source control plug-in sample at \Program Files\VSIP 8.0\MSSCCI\.
LPTEXTOUTPROC describes the callback function that is used by SccOpenProject to display messages from the source control plug-in through the IDE.
POPLISTFUNC describes the callback function that is used by SccPopulateList when the IDE does not have complete access to information that is available only to the source control plug-in, such as a complete list of files under version control.
QUERYCHANGESFUNC describes the callback function that is used by the SccQueryChanges operation.
POPDIRLISTFUNC describes the callback function that is used by the SccPopulateDirList operation.
OPTNAMECHANGEPFN describes the callback function set by a call to the SccSetOption that enables the source control plug-in to communicate name changes back to the IDE.
SccOpenProject opens a project.
SccPopulateList examines the list of files for their current status. In addition, uses the
pfnPopulate
function to notify the caller when a file does not match the criteria for thenCommand
.SccPopulateDirList examines a list of directories and files in a project or projects that are under source control. Each directory and file name found is passed to a callback function.
SccQueryChanges examines name changes that were made to a list of files. Each file name is passed to a callback function together with its change status.
SccSetOption sets a wide variety of options. Each option starts with
SCC_OPT_xxx
and has its own defined set of values.Source Control Plug-ins describes the contents of the reference section of the Source Control Plug-in SDK.