__VSGSIFLAGS Enum

Definition

Namespace:

Microsoft.VisualStudio.Shell.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.11.40262

Provides information about selection items and the VSITEMSELECTION structure.

This enumeration supports a bitwise combination of its member values.

public enum class __VSGSIFLAGS

public enum class __VSGSIFLAGS

enum __VSGSIFLAGS

[System.Flags]
public enum __VSGSIFLAGS

[<System.Flags>]
type __VSGSIFLAGS = 

Public Enum __VSGSIFLAGS

Inheritance

Enum

__VSGSIFLAGS

Attributes

FlagsAttribute

Fields

Name	Value	Description
GSI_fOmitHierPtrs	1	Indicates that the pHier field of VSITEMSELECTION structure should not be filled in (and therefore not AddRef()'d). This is useful in a case where a selection is within one hierarchy, as this value does not need to be filled. The pHier was already obtained through GetCurrentSelection(IntPtr, UInt32, IVsMultiItemSelect, IntPtr) or through OnSelectionChanged(IVsHierarchy, UInt32, IVsMultiItemSelect, ISelectionContainer, IVsHierarchy, UInt32, IVsMultiItemSelect, ISelectionContainer).

Remarks

COM Signature

From vsshell.idl:

Currently there is only one element of the __VSGSIFLAGS enumeration: GSI_fOmitHierPtrs. When set, GSI_fOmitHierPtrs indicates that the pHier member of the VSITEMSELECTION structure should not contain an IVsHierarchy pointer; it should remain null and therefore not be added to the reference count with IUnknown::AddRef.

Setting the GSI_fOmitHierPtrs flag is an optimization that is useful if a selection resides within one hierarchy. Because the IVsHierarchy pointer for the selection was already obtained through GetCurrentSelection or OnSelectionChanged, it need not be retrieved again.