Source Control Plug-in API Functions
The Source Control Plug-in API provides the following functions, which must be implemented by the source control plug-in in accordance with this API. The signatures of each function and the semantics associated with the bit flags and other parameters are described in detail in this reference.
|
Function |
Description |
|---|---|
|
Closes a project. |
|
|
Prompts the user for advanced options for the given command. |
|
|
Returns the version of the source control plug-in. |
|
|
Initializes the source control plug-in. It is called once for each instance of the plug-in. |
|
|
Opens a project. |
|
|
A generic function used to set a wide variety of options. Each option starts with SCC_OPT_xxx and has its own defined set of values. |
|
|
Called once when a source control plug-in needs to be unplugged. |
|
Function |
Description |
|---|---|
|
Adds an array of files specified by fully qualified path names to the source control system. |
|
|
Allows the user to browse for files that are already in the source control system and then make those files part of the current project. |
|
|
Checks in an array of files. |
|
|
Checks out an array of files. |
|
|
Shows the differences between the local user's file specified by a fully qualified path name and the version under source control. |
|
|
Retrieves a read-only copy of a set of files. |
|
|
Checks the status of files that the caller has asked about (via SccQueryInfo). |
|
|
Causes the source control plug-in to prompt the user for a project path that is meaningful to the plug-in. |
|
|
Shows the history for an array of fully qualified local file names. |
|
|
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 the nCommand. |
|
|
Shows the properties of a fully qualified file. |
|
|
Examines a list of fully qualified files for their current status. |
|
|
Removes the array of fully qualified files from the source control system. |
|
|
Renames the given file to a new name in the source control system. |
|
|
Accesses the full range of features of the source control system. |
|
|
Undoes a checkout of an array of files. |
This group of functions defines the additional functionality included in version 1.2 of the Source Control Plug-in API. They provide access to more advanced source control features and capabilities.
|
Function |
Description |
|---|---|
|
Starts a batch operation. |
|
|
Creates a subproject with the given name under an existing parent project. |
|
|
Shows the differences between the local user's directory specified by a fully qualified path name and the source control database location. |
|
|
Examines a list of fully qualified directories for their current status. |
|
|
Ends a batch operation. |
|
|
Returns parent path of the given project (the project must exist). |
|
|
Checks whether multiple checkouts on a file are allowed. |
|
|
Checks whether the plug-in will create MSSCCPRJ.SCC files. |
This group of functions defines the additional functionality included in version 1.3 of the Source Control Plug-in API. They provide access to more advanced source control features and capabilities.
|
Function |
Description |
|---|---|
|
Adds a list of files from source control to the current project. |
|
|
Retrieves a list of files from source control without a user interface. |
|
|
Retrieves a list of files in source control that are different from the local files. |
|
|
Retrieves flags that specify extended capabilities supported by the source control plug-in. |
|
|
Retrieves user-specific options. |
|
|
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. |
|
|
Examines name changes made to a list of files. Each file name is passed to a callback function with its change status. |