CSnapInItemImpl::SetMenuInsertionFlags
更新 : 2007 年 11 月
スナップイン オブジェクトに対して pInsertionAllowed で指定されたメニュー挿入フラグを変更します。
void SetMenuInsertionFlags(
bool bBeforeInsertion,
long* pInsertionAllowed
);
パラメータ
bBeforeInsertion
[入力] アイテムをコンテキスト メニューに追加する前に関数を呼び出す必要がある場合は 0 以外。それ以外の場合は 0。pInsertionAllowed
[入出力] 使用できる Microsoft 管理コンソール (MMC : Microsoft Management Console) 定義のメニュー アイテム挿入位置。次のフラグを組み合わせて指定できます。CCM_INSERTIONALLOWED_TOP コンテキスト メニューの先頭にアイテムを挿入できます。
CCM_INSERTIONALLOWED_NEW [CREATE NEW] サブメニューにアイテムを挿入できます。
CCM_INSERTIONALLOWED_TASK [TASK] サブメニューにアイテムを挿入できます。
CCM_INSERTIONALLOWED_VIEW ツール バー表示メニューまたは結果ペイン コンテキスト メニューの [VIEW] サブメニューにアイテムを挿入できます。
解説
プライマリ スナップインを開発している場合は、サードパーティの拡張機能が追加できるメニュー アイテムの種類を制限する手段として、どの挿入フラグもリセットできます。たとえば、プライマリ スナップインは CCM_INSERTIONALLOWED_NEW フラグをクリアして、拡張機能が独自の [CREATE NEW] メニュー アイテムを追加するのを禁止できます。
pInsertionAllowed の最初からクリアされていたビットは設定しないでください。現在定義されていないビットは MMC の将来のバージョンで使用する可能性があるので、変更しないでください。
必要条件
ヘッダー : atlsnap.h