CSnapInItemImpl::SetMenuInsertionFlags

void SetMenuInsertionFlags( bool bBeforeInsertion, long* pInsertionAllowed );

Parameters

bBeforeInsertion

[in] Nonzero if the function should be called before items are added to the context menu; otherwise 0.

pInsertionAllowed

[in, out] Identifies MMC-defined, menu-item insertion points that can be used. This can be a combination of the following flags:

• CCM_INSERTIONALLOWED_TOP   Items can be inserted at the top of a context menu.
  
  
• CCM_INSERTIONALLOWED_NEW   Items can be inserted in the Create New submenu.
  
  
• CCM_INSERTIONALLOWED_TASK   Items can be inserted in the Task submenu.
  
  
• CCM_INSERTIONALLOWED_VIEW   Items can be inserted in the toolbar view menu or in the View submenu of the result pane context menu.

Remarks

Call this function to modify the menu insertion flags, specified by pInsertionAllowed, for the snap-in object.

If you are developing a primary snap-in, you can reset any of the insertion flags as a way of restricting the kind of menu items that a third-party extension can add. For example, the primary snap-in can clear the CCM_INSERTIONALLOWED_NEW flag to prevent extensions from adding their own Create New menu items.

You should not attempt to set bits in pInsertionAllowed that were originally cleared. Future versions of MMC may use bits not currently defined so you should not change bits that are currently not defined.

CSnapInItemImpl Overview |  Class Members