Share via


IVsSccProjectEnlistmentChoice.GetEnlistmentChoice Method

Definition

Determines whether an enlistment choice should be given to the user each time a project is checked out from source control.

public:
 int GetEnlistmentChoice(cli::array <Microsoft::VisualStudio::Shell::Interop::VSSCCENLISTMENTCHOICE> ^ pvscecEnlistmentChoice);
public:
 int GetEnlistmentChoice(Platform::Array <Microsoft::VisualStudio::Shell::Interop::VSSCCENLISTMENTCHOICE> ^ pvscecEnlistmentChoice);
int GetEnlistmentChoice(std::Array <Microsoft::VisualStudio::Shell::Interop::VSSCCENLISTMENTCHOICE> const & pvscecEnlistmentChoice);
public int GetEnlistmentChoice (Microsoft.VisualStudio.Shell.Interop.VSSCCENLISTMENTCHOICE[] pvscecEnlistmentChoice);
abstract member GetEnlistmentChoice : Microsoft.VisualStudio.Shell.Interop.VSSCCENLISTMENTCHOICE[] -> int
Public Function GetEnlistmentChoice (pvscecEnlistmentChoice As VSSCCENLISTMENTCHOICE()) As Integer

Parameters

pvscecEnlistmentChoice
VSSCCENLISTMENTCHOICE[]

[out] Returns a value from the VSSCCENLISTMENTCHOICE enumeration indicating whether an enlistment choice is required, optional, or not supported.

Returns

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From ivssccprojectenlistmentchoice.idl

HRESULT GetEnlistmentChoice(  
   [out, retval] VSSCCENLISTMENTCHOICE * pvscecEnlistmentChoice  
);  

This method allows a project to specify one of the following:

  • It never requires a new enlistment when the project is checked out of source control.

  • The user should be given the choice of setting a new enlistment location.

  • It must ask the user for a new enlistment location each time the project is checked out.

Visual Studio supplies the dialog box that asks the user for the enlistment choice. The IVsSccProjectEnlistmentFactory interface is then called to give the user the option of browsing for the enlistment and/or editing the suggested enlistment (if they are allowed to change the suggested enlistment at all). Once the enlistment has been established, the IVsSccEnlistmentPathTranslation interface is used to translate between the enlistment path and the source control path.

Applies to