This documentation is archived and is not being maintained.

__VSGSIFLAGS Enumeration

Provides information about selection items and the VSITEMSELECTION structure.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in

public enum __VSGSIFLAGS
/** @attribute FlagsAttribute() */ 
public enum __VSGSIFLAGS
public enum __VSGSIFLAGS

 Member nameDescription
GSI_fOmitHierPtrsIndicates 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 or through OnSelectionChanged.  

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 a null reference (Nothing in Visual Basic) 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.