Bitflags Used by Specific Commands
The behavior of a number of functions in the Source Control Plug-in API can be modified by setting one or more bits in a single value. These values are known as bitflags. The various bitflags used by the Source Control Plug-in API are detailed here, grouped by the function that uses them.
These flags are used by the SccAdd Function.
The source control plug-in is expected to automatically detect whether the file is text or binary.
File type is text.
File type is binary.
SCC_FILETYPE_TEXT and SCC_FILETYPE_BINARY flags are mutually exclusive. Set exactly one or neither.
Store latest version only (no deltas).
The SccDiff Function uses these flags to define the scope of a diff operation. The SCC_DIFF_QD_xxx flags are mutually exclusive. If any one of them is specified, then no visual feedback is to be given. In a "quick diff" (QD), the plug-in does not determine how the file is different, only if it is different. If none of these flags is specified, a "visual diff" is done; detailed file differences are computed and displayed. If the requested QD is not supported, the plug-in moves to the next best one. For instance, if the IDE requests a checksum, and the plug-in does not support it, the plug-in does a full-contents check (still much faster than a visual display).
Ignore case differences.
Ignore white-space differences.
The SCC_DIFF_IGNORECASE and SCC_DIFF_IGNORESPACE flags are optional bitflags.
QD by comparing entire file contents.
QD by checksum.
QD by file date/time stamp.
This is a mask used to check all the QD bitflags. It should not be passed into a function; the three QD bitflags are mutually exclusive. QD always means no display of UI.
This flag is used by the SccPopulateList Function in the fOptions parameter.
The IDE is passing directories, not files.
These flags are used by the SccPopulateDirList Function in the fOptions parameter.
Examine only one level of directories for directories (this is the default).
Recursively examine all directories under each given directory.
Include file names in the examination process.
These flags are used by the SccOpenProject Function in the dwFlags parameter.
If project doesn't exist in source control, create it. If this flag is not set, prompt user for project to create (unless SCC_OP_SILENTOPEN flag is specified).
Do not prompt user to create a project; just return SCC_E_UNKNOWNPROJECT.
The IDE is passing directories, not files: Get all files in these directories.
The IDE is passing directories: Get these directories and all their subdirectories.
These flags are used by the SccSetOption Function in the nOption parameter.
Set status of the event queue.
Specify user data for SCC_OPT_NAMECHANGEPFN.
The IDE can handle cancel
Set a callback for name changes.
Disable source control plug-in UI checkout and do not set working directory.
Add from the source control system to specify a working directory. Try to share into the associated project if it is a direct descendant.
These flags are used by the SccSetOption Function in the dwVal parameter.
Used by nOption value
Suspends event queue activity.
Enables event queue logging.
(Default) Has no cancel mode; plug-in must supply if desired.
IDE handles cancel.
(Default) OK to check out from plug-in UI; working directory is set.
No plug-in UI checkout, no working directory.