This documentation is archived and is not being maintained.

VSSFlags Enumeration 

Visual Studio 2005

Defines various SourceSafe settings.

Namespace: Microsoft.VisualStudio.SourceSafe.Interop
Assembly: Microsoft.VisualStudio.SourceSafe.Interop (in microsoft.visualstudio.sourcesafe.interop.dll)

[FlagsAttribute] 
[GuidAttribute("783CD4EF-9D54-11CF-B8EE-00608CC9A71F")] 
public enum VSSFlags
/** @attribute FlagsAttribute() */ 
/** @attribute GuidAttribute("783CD4EF-9D54-11CF-B8EE-00608CC9A71F") */ 
public enum VSSFlags
FlagsAttribute 
GuidAttribute("783CD4EF-9D54-11CF-B8EE-00608CC9A71F") 
public enum VSSFlags

 Member nameDescription
VSSFLAG_BINBINARYIndicates that a file is binary.  

When this flag is set, SourceSafe sets the added file type to binary.

This flag belongs to the group of flags:

VSSFLAG_BINBINARY

VSSFLAG_BINTEST (default)

VSSFLAG_BINTEXT

VSSFLAG_BINTESTIndicates that Visual SourceSafe auto-detects the file to determine whether it is text or binary. 

When this flag is set, SourceSafe auto-detects the added file type. SourceSafe looks for embedded NULL characters during the test to determine type.

This flag belongs to the group of flags:

VSSFLAG_BINBINARY

VSSFLAG_BINTEST (default)

VSSFLAG_BINTEXT

VSSFLAG_BINTEXTIndicates that a file is text. 

When this flag is set, SourceSafe sets the added file type to text.

This flag belongs to the group of flags:

VSSFLAG_BINBINARY

VSSFLAG_BINTEST (default)

VSSFLAG_BINTEXT

VSSFLAG_CHKEXCLUSIVENOIndicates that a checkout is non-exclusive. Multiple checkouts are allowed with this option. 

When this flag is set, SourceSafe allows the IVSSItem to be checked out by multiple users.

SourceSafe allows the files to be checked out by more than one user. The Allow Multiple CheckOuts option in the SourceSafe Admin utility must be set for this flag to be effective. If the Allow Multiple CheckOuts option is not set, this flag is ignored, and all files are checked out exclusively. The Allow Multiple CheckOuts option is not exposed in VSS Automation.

This flag belongs to the group of flags:

VSSFLAG_CHKEXCLUSIVENO (default if Allow Multiple CheckOutsis enabled)

VSSFLAG_CHKEXCLUSIVEYES (default if Allow Multiple CheckOuts is disabled)

VSSFLAG_CHKEXCLUSIVEYESIndicates that a checkout is exclusive.  

When this flag is set, SourceSafe prevents the item from being checked out by multiple users.

SourceSafe allows the files to be checked out by more than one user. The Allow Multiple CheckOuts option in the SourceSafe Admin utility must be set for this flag to be effective. If the Allow Multiple CheckOuts option is not set, this flag is ignored, and all files are checked out exclusively. The Allow Multiple CheckOuts option is not exposed in Automation.

This flag belongs to the group of flags:

VSSFLAG_CHKEXCLUSIVENO (default if Allow Multiple CheckOutsis enabled)

VSSFLAG_CHKEXCLUSIVEYES (default if Allow Multiple CheckOuts is disabled)

VSSFLAG_CKOUTLOCALVERThis indicates the check out model to be used when performing a check out. If this flag is specified, the check out operation will not retrieve the latest version of the file being checked out. Instead it will check out the version that was most recently gotten in to the working folder. If the flag is not specified, then the check out will download the latest version. 
VSSFLAG_CMPCHKSUMSpecifies a checksum comparison. This is the default flag. 

Use this flag with the Checkin, Get, or UndoCheckout methods to compare checksums of the local copy and the SourceSafe master copy. If the local copy is up-to-date, SourceSafe does not replace it with the master copy.

This flag identifies the recommended difference comparison mechanism.

This flag belongs to the group of flags:

VSSFLAG_CMPCHKSUM (default)

VSSFLAG_CMPFAIL

VSSFLAG_CMPFULL

VSSFLAG_CMPTIME

Only one flag from this group may be used at a time.

VSSFLAG_CMPFAILSpecifies no comparison mechanism. 

Use this flag with the Checkin, Get, or UndoCheckout methods to always replace the local copy with the SourceSafe master copy.

This flag belongs to the group of flags:

VSSFLAG_CMPCHKSUM (default)

VSSFLAG_CMPFAIL

VSSFLAG_CMPFULL

VSSFLAG_CMPTIME

Only one flag from this group may be used at a time.

VSSFLAG_CMPFULLSpecifies a full text comparison. 

Use this flag with the Checkin, Get, or UndoCheckout methods to compare the text contents of the local copy and the SourceSafe master copy. If the local copy is up-to-date, SourceSafe does not replace it with the master copy.

This flag belongs to the group of flags:

VSSFLAG_CMPCHKSUM (default)

VSSFLAG_CMPFAIL

VSSFLAG_CMPFULL

VSSFLAG_CMPTIME

Only one flag from this group may be used at a time.

VSSFLAG_CMPTIMESpecifies a timestamp comparison. 

Use this flag with the Checkin, Get, or UndoCheckout methods to compare date/time stamp of the local copy and the SourceSafe master copy. If the local copy is up-to-date, SourceSafe does not replace it with the master copy.

This flag belongs to the group of flags:

VSSFLAG_CMPCHKSUM (default)

VSSFLAG_CMPFAIL

VSSFLAG_CMPFULL

VSSFLAG_CMPTIME

Only one flag from this group may be used at a time.

VSSFLAG_DELNO 

Indicates whether the local copy should be deleted after an Add, Checkin, or UndoCheckout.

When this flag is set, the local copy is not deleted.

This flag belongs to the group of flags:

VSSFLAG_DELYES

VSSFLAG_DELNO (default)

VSSFLAG_DELNOREPLACE

VSSFLAG_DELNOREPLACEIndicates that the local copy of a file is not replaced by an UndoCheckout operation. 

When this flag is set, the local copy is not replaced with the SourceSafe master copy and its read-only flag is set to true.

This flag belongs to the group of flags:

VSSFLAG_DELYES

VSSFLAG_DELNO (default)

VSSFLAG_DELNOREPLACE

VSSFLAG_DELTANOIndicates that an added file does not retain its historical versions. 

Use this flag with the Add method.

When this flag is set, the file does not retain its historical versions.

This flag belongs to the group of flags:

VSSFLAG_DELTAYES (default)

VSSFLAG_DELTANO

VSSFLAG_DELTAYESIndicates that an added file retains its historical versions. 

Use this flag with the Add method.

When this flag is set, the file retains its historical versions.

This flag belongs to the group of flags:

VSSFLAG_DELTAYES (default)

VSSFLAG_DELTANO

VSSFLAG_DELYESIndicates that the local copy of a file is deleted when it is checked in. 

Indicates whether the local copy should be deleted after an Add, Checkin, or UndoCheckout.

When this flag is set, the local copy is deleted.

This flag belongs to the group of flags:

VSSFLAG_DELYES

VSSFLAG_DELNO (default)

VSSFLAG_DELNOREPLACE

VSSFLAG_EOLCRIndicates that an end-of-line character is a carriage-return. 

Use this flag with the Checkout, Get, or Branch methods.

When this flag is set, SourceSafe appends a carriage-return character to the end of the text file that does not end with a carriage-return. Only one constant from this group may be used at a time.

This flag belongs to the group of flags:

VSSFLAG_EOLCR

VSSFLAG_EOLLF

VSSFLAG_EOLCRLF

If no flags are set, the end-of-line character is not modified.

VSSFLAG_EOLCRLFIndicates that an end-of-line character is a carriage-return/line-feed. This is the default. 

Use this flag with the Checkout, Get, or Branch methods.

When this flag is set, SourceSafe appends carriage-return and line-feed characters to the end of the text file that does not end with a carriage-return/line-feed. Only one constant from this group may be used at a time.

This flag belongs to the group of flags:

VSSFLAG_EOLCR

VSSFLAG_EOLLF

VSSFLAG_EOLCRLF

If no flags are set, the end-of-line character is not modified.

VSSFLAG_EOLLFIndicates that an end-of-line character is a line-feed. 

Use this flag with the Checkout, Get, or Branch methods.

When this flag is set, SourceSafe appends a line-feed character to the end of the text file that does not end with a line-feed. Only one constant from this group may be used at a time.

This flag belongs to the group of flags:

VSSFLAG_EOLCR

VSSFLAG_EOLLF

VSSFLAG_EOLCRLF

If no flags are set, the end-of-line character is not modified.

VSSFLAG_FORCEDIRNOUsed to override the working folder specifications. 

Use this flag with the GetSystem.String@,System.Int32), Checkout, Checkin, UndoCheckout, or Branch methods.

This flag belongs to the group of flags:

VSSFLAG_FORCEDIRNO

VSSFLAG_FORCEDIRYES (default)

VSSFLAG_FORCEDIRYESUsed to maintain the working folder settings. This is the default. 

Use this flag with the GetSystem.String@,System.Int32), Checkout, Checkin, UndoCheckout, or Branch methods.

This flag belongs to the group of flags:

VSSFLAG_FORCEDIRNO

VSSFLAG_FORCEDIRYES (default)

VSSFLAG_GETNOIndicates that the local copy should not be replaced with the SourceSafe master copy on commands that do an automatic Get. 

Use this flag with the Checkoutand Share methods.

When this flag is set, the local copy is not replaced with the master copy.

This flag belongs to the group of flags:

VSSFLAG_GETYES (default)

VSSFLAG_GETNO

VSSFLAG_GETYESIndicates that the local copy should be replaced with the SourceSafe master copy on commands that do an automatic Get. 

Use this flag with the Checkout and Share methods.

When this flag is set, the local copy is replaced with the master copy.

This flag belongs to the group of flags:

VSSFLAG_GETYES (default)

VSSFLAG_GETNO

VSSFLAG_HISTIGNOREFILESIndicates that the file check ins are excluded from the IVSSVersions collection.  

When this flag is set, the file check ins are excluded from the IVSSVersions collection.

VSSFLAG_KEEPNOIndicates that SourceSafe does not keep a file checked out during a check in operation. 

Use this flag with the Add, or Checkin methods.

When this flag is set, the file is checked in and the local copy is set to read-only.

This flag belongs to the group of flags:

VSSFLAG_KEEPYES

VSSFLAG_KEEPNO (default)

VSSFLAG_KEEPYESIndicates that SourceSafe keeps a file checked out during a check in operation. 

Use this flag with the Add or Checkin methods.

When this flag is set, the file remains checked out and the local copy is set to read/write.

This flag belongs to the group of flags:

VSSFLAG_KEEPYES

VSSFLAG_KEEPNO (default)

VSSFLAG_RECURSNOIndicates that a command should not be recursive (act on an entire project tree). This is the default. 

Use this flag with the Checkin, Checkout, Get or Share methods.

When this flag is set, the command is non-recursive.

This flag belongs to the group of flags:

VSSFLAG_RECURSNO (default)

VSSFLAG_RECURSYES

VSSFLAG_RECURSYESIndicates that a command should be recursive (act on an entire project tree). 

Use this flag with the Checkin, Checkout, Get, or Share methods.

When this flag is set, the command is recursive.

This flag belongs to the group of flags:

VSSFLAG_RECURSNO (default)

VSSFLAG_RECURSYES

VSSFLAG_REPASKRepresents the use of a dialog box that prompts the user to determine whether the writable file is replaced, skipped, or merged. This is the default. 

Use this flag with the Branch, Checkin, Checkout, GetSystem.String@,System.Int32), or UndoCheckout methods.

Use these constants to specify local computer action for writable files. Only one constant from this group may be used at a time. This flag belongs to the group of flags:

VSSFLAG_REPASK

VSSFLAG_REPMERGE

VSSFLAG_REPREPLACE

VSSFLAG_REPSKIP

VSSFLAG_REPMERGERepresents merge changes for writable files on the local computer. 

Use this flag with the Branch, Checkin, Checkout, GetSystem.String@,System.Int32), or UndoCheckout methods.

When this flag is set, SourceSafe merges files at the same time modified by multiple users into the local copy. Use these constants to specify local computer action for writable files. Only one constant from this group may be used at a time.

This flag belongs to the group of flags:

VSSFLAG_REPASK

VSSFLAG_REPMERGE

VSSFLAG_REPREPLACE

VSSFLAG_REPSKIP

VSSFLAG_REPREPLACEA flag that represents that writable files on the local computer are replaced. 

Use this flag with the Branch, Checkin, Checkout, GetSystem.String@,System.Int32), or UndoCheckout methods.

When this flag is set, the local copy is replaced with the SourceSafe master copy. Use these constants to specify local computer action for writable files. Only one constant from this group may be used at a time.

This flag belongs to the group of flags:

VSSFLAG_REPASK

VSSFLAG_REPMERGE

VSSFLAG_REPREPLACE

VSSFLAG_REPSKIP

VSSFLAG_REPSKIPA flag that represents that writable files on the local computer are skipped.  

Use this flag with the Branch, Checkin, Checkout, GetSystem.String@,System.Int32), or UndoCheckout methods.

When this flag is set, the local writable copy is not replaced with the SourceSafe master copy. Use these constants to specify local computer action for writable files. Only one constant from this group may be used at a time.

This flag belongs to the group of flags:

VSSFLAG_REPASK

VSSFLAG_REPMERGE

VSSFLAG_REPREPLACE

VSSFLAG_REPSKIP

VSSFLAG_TIMEMODTimestamp uses the last modified time. 

Use this flag with the Branch, Checkout, or Get methods.

When this flag is set, the date/time of the local copy is set to last modification date and time. This is typically used during a Get operation. Only one constant from this group may be used at a time.

This flag belongs to the group of flags:

VSSFLAG_TIMEMOD

VSSFLAG_TIMENOW (default)

VSSFLAG_TIMEUPD

VSSFLAG_TIMENOWTimestamp uses the current time. This is the default. 

Use this flag with the Branch, Checkout, or Get methods.

When this flag is set, the date/time of the local copy is set to the current date and time. This is typically used during a Get operation. Only one constant from this group may be used at a time.

This flag belongs to the group of flags:

VSSFLAG_TIMEMOD

VSSFLAG_TIMENOW (default)

VSSFLAG_TIMEUPD

VSSFLAG_TIMEUPDTimestamp uses the last check in time. 

Use this flag with the Branch, Checkout, or Get methods.

When this flag is set, the date/time of the local copy is set to the date and time of the last check-in. This is typically used during a Get operation. Only one constant from this group may be used at a time.

This flag belongs to the group of flags:

VSSFLAG_TIMEMOD

VSSFLAG_TIMENOW (default)

VSSFLAG_TIMEUPD

VSSFLAG_UPDASKIndicates that the user will be prompted to answer whether an unchanged local copy should be registered as a Checkin or an UndoCheckout

This flag belongs to the group of flags:

VSSFLAG_UPDASK

VSSFLAG_UPDUNCH (default)

VSSFLAG_UPDUPDATE

VSSFLAG_UPDUNCHIndicates that an unchanged local copy will cause an UndoCheckout when a Checkin is attempted. 

Use this flag with the Checkin method.

When this flag is set, SourceSafe does UndoCheckout of the unchanged local copy.

This flag belongs to the group of flags:

VSSFLAG_UPDASK

VSSFLAG_UPDUNCH (default)

VSSFLAG_UPDUPDATE

VSSFLAG_UPDUPDATEIndicates that an unchanged local copy performs a Checkin

When this flag is set, SourceSafe does Checkin of the unchanged local copy and creates a new IVSSVersion.

This flag belongs to the group of flags:

VSSFLAG_UPDASK

VSSFLAG_UPDUNCH (default)

VSSFLAG_UPDUPDATE

VSSFLAG_USERRONOUsed to set the file read-only flag to OFF.  

It is recommended that you do not use this constant.

This flag belongs to the following group of flags:

VSSFLAG_USERROYES

VSSFLAG_USERRONO

VSSFLAG_USERROYESUsed to set the file read-only flag to OFF. This is the default flag.  

It is recommended that you do not use this constant.

This flag belongs to the following group of flags:

VSSFLAG_USERROYES

VSSFLAG_USERRONO

SourceSafe settings are defined by the system and/or the SS.INI file of the current user. If you want to change a particular behavior, you must set one or several flags. You can combine flags using the following syntax:

VSSFLAG_RECURSNO+VSSFLAG_USERROYES, or

VSSFLAG_RECURSNO|VSSFLAG_USERROYES.

Show: