__VSGSIFLAGS Enumeration

 

Provides information about selection items and the VSITEMSELECTION structure.

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

[FlagsAttribute]
public enum __VSGSIFLAGS

Member nameDescription
GSI_fOmitHierPtrs

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

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.

Return to top
Show: