__VSGSIFLAGS Enumeration
Provides information about selection items and the VSITEMSELECTION structure.
Assembly: Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)
| Member name | Description | |
|---|---|---|
| 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.