Capability Flags

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at Capability Flags.

The SCC_CAP_xxx flags are bit flags used to indicate the capabilities of a source control plug-in. The SCC_EXCAP_xxx flags are incremental flags that indicate extended capabilities and resolve to integer values.

Capability CodeValueDescription
SCC_CAP_REMOVE0x00000001LSupports the SccRemove and command.
SCC_CAP_RENAME0x00000002LSupports the SccRename and command.
SCC_CAP_DIFF0x00000004LSupports the SccDiff and command.
SCC_CAP_HISTORY0x00000008LSupports the SccHistory and command.
SCC_CAP_PROPERTIES0x00000010LSupports the SccProperties and command.
SCC_CAP_RUNSCC0x00000020LSupports the SccRunScc and command.
SCC_CAP_GETCOMMANDOPTIONS0x00000040LSupports the SccGetCommandOptions and command.
SCC_CAP_QUERYINFO0x00000080LSupports the SccQueryInfo and command.
SCC_CAP_GETEVENTS0x00000100LSupports the SccGetEvents and command.
SCC_CAP_GETPROJPATH0x00000200LSupports the SccGetProjPath and command.
SCC_CAP_ADDFROMSCC0x00000400LSupports the SccAddFromScc and command.
SCC_CAP_COMMENTCHECKOUT0x00000800LSupports a comment on checkout.
SCC_CAP_COMMENTCHECKIN0x00001000LSupports a comment on checkin.
SCC_CAP_COMMENTADD0x00002000LSupports a comment on Add.
SCC_CAP_COMMENTREMOVE0x00004000LSupports a comment on Remove.
SCC_CAP_TEXTOUT0x00008000LWrites text to an IDE-provided output function.
SCC_CAP_ADD_STORELATEST0x00200000LSupports storing files without deltas.
SCC_CAP_HISTORY_MULTFILE0x00400000LSupports multiple file history.
SCC_CAP_IGNORECASE0x00800000LSupports case-insensitive file comparison.
SCC_CAP_IGNORESPACE0x01000000LSupports file comparison that ignores white space.
SCC_CAP_POPULATELIST0x02000000LSupports finding extra files.
SCC_CAP_COMMENTPROJECT0x04000000LSupports comments on create project.
SCC_CAP_DIFFALWAYS0x10000000LSupports diff in all states if under control.
SCC_CAP_GET_NOUI0x20000000LPlug-in does not support a UI for Get, but IDE may still call SccGet.
SCC_CAP_REENTRANT0x40000000LPlug-in is reentrant and thread-safe. In version 1.0, no plug-ins were assumed to be reentrant and thread-safe. If a 1.1 plug-in sets this bit, the host is allowed to open multiple projects in parallel.
Capability CodeValueDescription
SCC_CAP_CREATESUBPROJECT0x00010000LSupports the SccCreateSubProject.
SCC_CAP_GETPARENTPROJECT0x00020000LSupports the SccGetParentProjectPath.
SCC_CAP_BATCH0x00040000LSupports the SccBeginBatch and SccEndBatch.
SCC_CAP_DIRECTORYSTATUS0x00080000LSupports the SccDirQueryInfo.
SCC_CAP_DIRECTORYDIFF0x00100000LSupports the SccDirDiff.
SCC_CAP_MULTICHECKOUT0x08000000LSupports multiple checkouts on a file and the SccIsMultiCheckoutEnabled.
SCC_CAP_SCCFILE0x80000000LSupports the MSSCCPRJ.SCC file (subject to user/administrator override) and the SccWillCreateSccFile.

These flags are passed one at a time to the SccGetExtendedCapabilities function to determine whether the capability is supported.

Extended Capability CodeValueDescription
SCC_EXCAP_CHECKOUT_LOCALVER1Supports the SCC_CHECKOUT_LOCALVER option for checkouts.
SCC_EXCAP_BACKGROUND_GET2Supports the SccBackgroundGet.
SCC_EXCAP_ENUM_CHANGED_FILES3Supports the SccEnumChangedFiles.
SCC_EXCAP_POPULATELIST_DIR4Supports finding extra directories.
SCC_EXCAP_QUERYCHANGES5Supports enumerating file changes.
SCC_EXCAP_ADD_FILES_FROM_SCC6Supports the SccAddFilesFromSCC.
SCC_EXCAP_GET_USER_OPTIONS7Supports the SccGetUserOption.
SCC_EXCAP_THREADSAFE_QUERY_INFO8Supports calling SccQueryInfo on multiple threads.
SCC_EXCAP_REMOVE_DIR9Supports the SccRemoveDir function.
SCC_EXCAP_DELETE_CHECKEDOUT10Can delete checked-out files.
SCC_EXCAP_RENAME_CHECKEDOUT11Can rename checked-out files.

Source Control Plug-ins

Show: