windows-nt/Source/XPSP1/NT/admin/activec/inc/ndmgrpriv.h
2020-09-26 16:20:57 +08:00

1359 lines
52 KiB
C++

//+-------------------------------------------------------------------------
//
// Microsoft Windows
//
// Copyright (C) Microsoft Corporation, 1999 - 1999
//
// File: ndmgrpriv.h (originally ndmgr.idl)
//
//--------------------------------------------------------------------------
#include "mmcobj.h"
#include <string>
#include <vector>
#include <iterator>
#ifndef __ndmgrpriv_h__
#define __ndmgrpriv_h__
#define MMC_INTERFACE(Interface, x) \
extern "C" const IID IID_##Interface; \
struct DECLSPEC_UUID(#x) __declspec(novtable) Interface
// forward class declarations
class CContextMenuInfo;
class CResultViewType;
class tstring;
class CColumnInfoList;
class CConsoleView;
class CXMLObject;
// interfaces
interface INodeType;
interface INodeTypesCache;
interface IEnumNodeTypes;
interface IFramePrivate;
interface IScopeDataPrivate;
interface IResultDataPrivate;
interface IImageListPrivate;
interface IPropertySheetNotify;
interface INodeCallback;
interface IScopeTreeIter;
interface IScopeTree;
interface IPropertySheetProviderPrivate;
interface IDumpSnapins;
interface IMMCListView;
interface ITaskPadHost;
interface IStringTablePrivate;
interface ITaskCallback;
interface IComCacheCleanup;
interface IHeaderCtrlPrivate;
interface IMMCClipboardDataObject;
interface IMMCClipboardSnapinObject;
typedef IFramePrivate* LPFRAMEPRIVATE;
typedef IScopeDataPrivate* LPSCOPEDATAPRIVATE;
typedef IResultDataPrivate* LPRESULTDATAPRIVATE;
typedef IImageListPrivate* LPIMAGELISTPRIVATE;
typedef IPropertySheetNotify* LPPROPERTYSHEETNOTIFY;
typedef INodeCallback* LPNODECALLBACK;
typedef IScopeTreeIter* LPSCOPETREEITER;
typedef IScopeTree* LPSCOPETREE;
typedef INodeType* LPNODETYPE;
typedef INodeTypesCache* LPNODETYPESCACHE;
typedef IEnumNodeTypes* LPENUMNODETYPES;
typedef IDumpSnapins* LPDUMPSNAPINS;
typedef IMMCListView* LPMMCLISTVIEW;
typedef ITaskCallback* LPTASKCALLBACK;
typedef IComCacheCleanup* LPCOMCACHECLEANUP;
typedef IMMCClipboardDataObject* LPCLIPBOARDDATAOBJECT;
typedef IMMCClipboardSnapinObject* LPCLIPBOARDSNAPINOBJECT;
typedef LONG_PTR HBOOKMARK;
typedef LONG_PTR HVIEWSETTINGS;
typedef LONG_PTR HPERSISTOR;
typedef IPropertySheetProviderPrivate* LPPROPERTYSHEETPROVIDERPRIVATE;
typedef struct _TREEITEM * HTREEITEM;
// Implements the list save feature (t-dmarm)
#define IMPLEMENT_LIST_SAVE
// Use to see if the MT Node is valid before referencing the saved pointer in
// a property sheet.
STDAPI MMCIsMTNodeValid(void* pMTNode, BOOL bReset);
// Window class used to store data for property sheets
#define MAINFRAME_CLASS_NAME L"MMCMainFrame"
// Window class used to store data for property sheets
#define DATAWINDOW_CLASS_NAME L"MMCDataWindow"
#define WINDOW_DATA_SIZE (sizeof (DataWindowData *))
// Slots for data stored in the data windows
#define WINDOW_DATA_PTR_SLOT 0
// Max length of item text in list/tree controls
// (including the terminating zero)
#define MAX_ITEM_TEXT_LEN 1024
// MID(Menu Identifications) for context menus
enum MID_LIST
{
MID_VIEW = 1,
MID_VIEW_LARGE,
MID_VIEW_SMALL,
MID_VIEW_LIST,
MID_VIEW_DETAIL,
MID_VIEW_FILTERED,
MID_VIEW_HTML,
MID_ARRANGE_ICONS,
MID_LINE_UP_ICONS,
MID_PROPERTIES,
MID_CREATE_NEW,
MID_TASK,
MID_EXPLORE,
MID_NEW_TASKPAD_FROM_HERE,
MID_OPEN,
MID_CUT,
MID_COPY,
MID_PASTE,
MID_DELETE,
MID_PRINT,
MID_REFRESH,
MID_RENAME,
MID_CONTEXTHELP,
MID_ARRANGE_AUTO,
MID_STD_MENUS,
MID_STD_BUTTONS,
MID_SNAPIN_MENUS,
MID_SNAPIN_BUTTONS,
MID_LISTSAVE,
MID_COLUMNS,
MID_CUSTOMIZE,
MID_ORGANIZE_FAVORITES,
MID_EDIT_TASKPAD,
MID_DELETE_TASKPAD,
MID_LAST, // this must be last
};
class CResultItem;
typedef struct _CCLVSortParams
{
BOOL bAscending; // sort direction
int nCol; // Which column to sort on.
LPRESULTDATACOMPARE lpResultCompare; // Snap-in component interface
LPRESULTDATACOMPAREEX lpResultCompareEx; // "
LPARAM lpUserParam; // parameter user passes in
BOOL bSetSortIcon; // Sort icon /*[not]*/ needed
/*
* Bug 414256: We need to save the sort data only if
* it is user initiated sort. Is this user initiated?
*/
BOOL bUserInitiatedSort;
} CCLVSortParams;
//
// This structure is used by MMCPropertyChangeNotify to pass
// information from a property sheet to the console. It has routing
// information to notify the correct snap-in of a property changed notify.
//
const DWORD MMC_E_INVALID_FILE = 0x80FF0002;
const DWORD MMC_E_SNAPIN_LOAD_FAIL = 0x80FF0003;
typedef struct _PROPERTYNOTIFYINFO
{
LPCOMPONENTDATA pComponentData; // Valid if (fScopePane == TRUE)
LPCOMPONENT pComponent; // Valid if (fScopePane == FALSE)
BOOL fScopePane; // True if it is for a scope pane item.
HWND hwnd; // HWND to console handling the message
} PROPERTYNOTIFYINFO;
// Context menu types
typedef enum _MMC_CONTEXT_MENU_TYPES
{
MMC_CONTEXT_MENU_DEFAULT = 0, // Normal context menu
MMC_CONTEXT_MENU_ACTION = 1, // Action menu button
MMC_CONTEXT_MENU_VIEW = 2, // View menu button
MMC_CONTEXT_MENU_FAVORITES = 3, // Favorites menu button
MMC_CONTEXT_MENU_LAST = 4,
} MMC_CONTEXT_MENU_TYPES;
DECLARE_HANDLE (HMTNODE);
DECLARE_HANDLE (HNODE); // A scope pane handle(lParam) within a view
typedef unsigned long MTNODEID;
const MTNODEID ROOTNODEID = 1;
typedef PROPERTYNOTIFYINFO* LPPROPERTYNOTIFYINFO;
// Special cookies (Note: Can't use -1)
const LONG_PTR LVDATA_BACKGROUND = -2;
const LONG_PTR LVDATA_CUSTOMOCX = -3;
const LONG_PTR LVDATA_CUSTOMWEB = -4;
const LONG_PTR LVDATA_MULTISELECT = -5;
const LONG_PTR LVDATA_ERROR = -10;
const LONG_PTR SPECIAL_LVDATA_MIN = -10;
const LONG_PTR SPECIAL_LVDATA_MAX = -2;
#define IS_SPECIAL_LVDATA(d) (((d) >= SPECIAL_LVDATA_MIN) && ((d) <= SPECIAL_LVDATA_MAX))
typedef struct _SELECTIONINFO
{
BOOL m_bScope;
BOOL m_bBackground;
IUnknown* m_pView; // valid for scope seln (CDN_SELECT)
MMC_COOKIE m_lCookie; // valid for result item (CCN_SELECT)
MMC_CONSOLE_VERB m_eCmdID;
BOOL m_bDueToFocusChange;
BOOL m_bResultPaneIsOCX;
BOOL m_bResultPaneIsWeb;
} SELECTIONINFO;
typedef struct _HELPDOCINFO
{
LPCOLESTR m_pszFileName; // File name (same as .msc file)
FILETIME m_ftimeCreate; // .msc file creation time
FILETIME m_ftimeModify; // .msc file modification time
} HELPDOCINFO;
// MMC_ILISTPAD_INFO struct: internal form has additional field for clsid
typedef struct _MMC_ILISTPAD_INFO
{
MMC_LISTPAD_INFO info;
LPOLESTR szClsid;
} MMC_ILISTPAD_INFO;
// *****************************************
// CLASS: CTaskPadData
// this class represents data set representing one TaskPad
// used to request taskpad information from CNode
// *****************************************
class CTaskPadData
{
public:
std::wstring strName;
CLSID clsidTaskPad;
};
typedef std::vector<CTaskPadData> CTaskPadCollection;
typedef std::insert_iterator<CTaskPadCollection> CTaskPadInsertIterator;
// *****************************************
// CLASS:CViewExtensionData
// this class represents data set representing one ViewExtension
// used to request extension information from CNode
// *****************************************
class CViewExtensionData
{
public:
std::wstring strURL;
std::wstring strName;
std::wstring strTooltip;
GUID viewID; // unique identifier for the view
bool bReplacesDefaultView;
};
typedef std::vector<CViewExtensionData> CViewExtCollection;
typedef std::insert_iterator<CViewExtCollection> CViewExtInsertIterator;
// The following internal flag corresponding to public view style MMC_ENSUREFOCUSVISIBLE.
// The flag is placed in the upper half of a long so it won't conflict with the LVS_*
// flags that are passed in the same long to our list control's SetViewStyle method.
#define MMC_LVS_ENSUREFOCUSVISIBLE 0x00010000
/*
NOTIFICATIONS
=============
Notify(dataobject, event, arg, param);
For all the MMC_NOTIFY_TYPE events,
dataobject = dataobject for cookie, can be NULL when dataobject is not required
event = one of the CD_NOTIFY_TYPEs
arg and param depend on type, see below.
NCLBK_ACTIVATE
arg = TRUE if gaining focus
NCLBK_BTN_CLICK
....
NCLBK_CLICK
NCLBK_CONTEXTMENU
param = CContextMenuInfo*
NCLBK_DBLCLICK
NCLBK_DELETE
arg = TRUE if scope item FALSE if result item.
param = If scope item is being deleted param is unused.
If result item is being deleted param is the result items cookie.
return = unused.
NCLBK_EXPAND
arg = TRUE => expand, FALSE => contract
NCLBK_EXPANDED
arg = TRUE => expanded, FALSE => contracted
NCLBK_FOLDER
arg = <>0 if expanding, 0 if contracting
param = HSCOPEITEM of expanding/contracting item
NCLBK_MINIMIZED
arg = TRUE if minimized
NCLBK_MULTI_SELECT
arg = TRUE if due to focus change.
param unused
NCLBK_PROPERTIES
pLParam = (CResultItem*)arg;
param unused
NCLBK_PROPERTY_CHANGE
lpDataObject = NULL
lParam = user object
NCLBK_NEW_NODE_UPDATE
arg = 1 => folder needs to be refreshed
arg = 2 => result view needs to be refreshed
arg = 3 => both needs to be refreshed
NCLBK_RENAME
This gets called the first time to query for rename and a
second time to do the rename. For the query S_OK or S_FALSE for the
return type. After the rename, we will send the new name with a LPOLESTR.
MMC_COOKIE lResultItemCookie = (MMC_COOKIE)arg;
pszNewName = (LPOLESTR)param; // the new name
return = S_OK to allow rename and S_FALSE to disallow rename.
NCLBK_SELECT
arg = TRUE if the item is selected, FALSE otherwise.
param = ptr to SELECTIONINFO.
NCLBK_SHOW
arg = <>0 if selecting, 0 if deselecting
param = HSCOPEITEM of selected/deselected item
NCLBK_COLUMN_CLICK
param = nCol, the column that was clicked.
NCLBK_FINDITEM
This message is sent when a result item list with owner data wants to find
an item who's name matches a string
arg = ptr to RESULTFINDINFO
param = ptr to returned item index
NCLBK_CACHEHINT
This message is sent when the result item list with owner data is about to
ask for display info for a range of items.
arg = index of start item
param = index of end item
NCLBK_GETHELPDOC
This message is sent to get the path of the combined help topics document.
The node manager may update the help doc info.
arg = pointer to HELPDOCINFO struct
param = pointer to returned path string (LPOLESTR*)
NCLBK_LISTPAD
This message is sent to tell the snapin that the TaskPad ListView is ready
to receive items (if attaching).
arg = TRUE if attaching, FALSE if detaching
NCLBK_WEBCONTEXTMENU
send when the user right clicks on a web page.
arg = unused
param = unused
NCLBK_UPDATEHELPDOC
send when console doc is saved to update help file name and file times
arg = ptr to current help doc info (HELPDOCINFO*)
param = ptr to new help doc info (HELPDOCINFO*)
NCLBK_DELETEHELPDOC
send when console doc is closed to delete the temp help collection file
associated with the document
arg - ptr to help doc info (HELPDOCINFO*)
param - unused
*/
typedef enum _NCLBK_NOTIFY_TYPE
{
NCLBK_NONE = 0x9000,
NCLBK_ACTIVATE = 0x9001,
NCLBK_CACHEHINT = 0x9002,
NCLBK_CLICK = 0x9003,
NCLBK_CONTEXTMENU = 0x9004,
NCLBK_COPY = 0x9005,
NCLBK_CUT = 0x9006,
NCLBK_DBLCLICK = 0x9007,
NCLBK_DELETE = 0x9008,
NCLBK_EXPAND = 0x9009,
NCLBK_EXPANDED = 0x900A,
NCLBK_FINDITEM = 0x900B,
NCLBK_FOLDER = 0x900C,
NCLBK_MINIMIZED = 0x900D,
NCLBK_MULTI_SELECT = 0x900E,
NCLBK_NEW_NODE_UPDATE = 0x900F,
NCLBK_PRINT = 0x9011,
NCLBK_PROPERTIES = 0x9012,
NCLBK_PROPERTY_CHANGE = 0x9013,
NCLBK_REFRESH = 0x9015,
NCLBK_RENAME = 0x9016,
NCLBK_SELECT = 0x9017,
NCLBK_SHOW = 0x9018,
NCLBK_COLUMN_CLICKED = 0x9019,
NCLBK_SNAPINHELP = 0x901D,
NCLBK_CONTEXTHELP = 0x901E,
NCLBK_INITOCX = 0x9020,
NCLBK_FILTER_CHANGE = 0x9021,
NCLBK_FILTERBTN_CLICK = 0x9022,
NCLBK_TASKNOTIFY = 0x9024,
NCLBK_GETPRIMARYTASK = 0x9025,
NCLBK_GETHELPDOC = 0x9027,
NCLBK_LISTPAD = 0x9029,
NCLBK_GETEXPANDEDVISUALLY = 0x902B,
NCLBK_SETEXPANDEDVISUALLY = 0x902C,
NCLBK_NEW_TASKPAD_FROM_HERE = 0x902D,
NCLBK_WEBCONTEXTMENU = 0x902E,
NCLBK_UPDATEHELPDOC = 0x902F,
NCLBK_EDIT_TASKPAD = 0x9030,
NCLBK_DELETE_TASKPAD = 0x9031,
NCLBK_DELETEHELPDOC = 0x9032
} NCLBK_NOTIFY_TYPE;
///////////////////////////////////////////////////////////////////////////////
// Common Console clipboard formats
//
// Clipboard format for the multi selected static nodes.
// If there are N static nodes are selected in the result pane, the MTNodes
// for these N nodes will be passed in a GloballAlloced memory. The first DWORD
// contains the number of MTNodes, this will be followed by N ptrs to the MTNodes.
//
#define CCF_MULTI_SELECT_STATIC_DATA ( L"CCF_MULTI_SELECT_STATIC_DATA" )
#define CCF_NEWNODE ( L"CCF_NEWNODE" )
//const CLSID CLSID_NDMGR_SNAPIN = {0x2640211a, 0x06d0, 0x11d1, {0xa7, 0xc9, 0x00, 0xc0, 0x4f, 0xd8, 0xd5, 0x65}};
extern const CLSID CLSID_NDMGR_SNAPIN;
//const GUID GUID_MMC_NEWNODETYPE = {0xfd17e9cc, 0x06ce, 0x11d1, {0xa7, 0xc9, 0x00, 0xc0, 0x4f, 0xd8, 0xd5, 0x65}};
extern const GUID GUID_MMC_NEWNODETYPE;
///////////////////////////////////////////////////////////////////////////
///
// helpstring("Notify that the properties of an object changed"),
MMC_INTERFACE(IPropertySheetNotify, d700dd8e-2646-11d0-a2a7-00c04fd909dd) : IUnknown
{
STDMETHOD(Notify)(/*[in]*/ LPPROPERTYNOTIFYINFO pNotify, /*[in]*/ LPARAM lParam) = 0;
};
// helpstring("IFramePrivate Interface"),
MMC_INTERFACE(IFramePrivate, d71d1f2a-1ba2-11d0-a29b-00c04fd909dd): IConsole3
{
/*[helpstring("Sets IFrame Result pane")]*/
STDMETHOD(SetResultView)(/*[in]*/ LPUNKNOWN pUnknown) = 0;
/*[helpstring("Is the ListView set as result view")]*/
STDMETHOD(IsResultViewSet)(BOOL* pbIsLVSet) = 0;
/*[helpstring("Sets Task Pads list view")]*/
STDMETHOD(SetTaskPadList)(/*[in]*/ LPUNKNOWN pUnknown) = 0;
/*[helpstring("IComponent's component ID")]*/
STDMETHOD(GetComponentID)(/*[out]*/ COMPONENTID* lpComponentID) = 0;
/*[helpstring("IComponent's component ID")]*/
STDMETHOD(SetComponentID)(/*[in]*/ COMPONENTID id) = 0;
/*[helpstring("Node for the view.")]*/
STDMETHOD(SetNode)(/*[in]*/ HMTNODE hMTNode, /*[in]*/ HNODE hNode) = 0;
/*[helpstring("Cache the IComponent interface for the snapin.")]*/
STDMETHOD(SetComponent)(/*[in]*/ LPCOMPONENT lpComponent) = 0;
/*[helpstring("Console name space.")]*/
STDMETHOD(QueryScopeTree)(/*[out]*/ IScopeTree** ppScopeTree) = 0;
/*[helpstring("Set the console name space.")]*/
STDMETHOD(SetScopeTree)(/*[in]*/ IScopeTree* pScopeTree) = 0;
/*[helpstring("Creates image list for the scope pane.")]*/
STDMETHOD(CreateScopeImageList)(/*[in]*/ REFCLSID refClsidSnapIn) = 0;
/*[helpstring("bExtension is TRUE if this IFrame is used by an extension.")]*/
STDMETHOD(SetUsedByExtension)(/*[in]*/ BOOL bExtension) = 0;
/*[helpstring("Init view data.")]*/
STDMETHOD(InitViewData)(/*[in]*/ LONG_PTR lViewData) = 0;
/*[helpstring("Clean up view data.")]*/
STDMETHOD(CleanupViewData)(/*[in]*/ LONG_PTR lViewData) = 0;
/*[helpstring("Reset the sort parameters after a selection change.")]*/
STDMETHOD(ResetSortParameters)() = 0;
};
// helpstring("IScopeDataPrivate Interface"),
MMC_INTERFACE(IScopeDataPrivate, 60BD2FE0-F7C5-11cf-8AFD-00AA003CA9F6) : IConsoleNameSpace2
{
};
// helpstring("IImageListPrivate Interface"),
MMC_INTERFACE(IImageListPrivate, 7538C620-0083-11d0-8B00-00AA003CA9F6) : IImageList
{
/*[helpstring("Private tree control method used to map images on callbacks")]*/
STDMETHOD(MapRsltImage)(COMPONENTID id, /*[in]*/ int nSnapinIndex, /*[out]*/ int* pnConsoleIndex) = 0;
/*[helpstring("Private tree control method used to map images on callbacks")]*/
STDMETHOD(UnmapRsltImage)(COMPONENTID id, /*[in]*/ int nConsoleIndex, /*[out]*/ int* pnSnapinIndex) = 0;
};
// helpstring("IResultDataPrivate Interface"),
MMC_INTERFACE(IResultDataPrivate, 1EBA2300-0854-11d0-8B03-00AA003CA9F6) : IResultData2
{
/*[helpstring("Get the list view style.")]*/
STDMETHOD(GetListStyle)(/*[out]*/ long * pStyle) = 0;
/*[helpstring("Set the list view style.")]*/
STDMETHOD(SetListStyle)(/*[in]*/ long Style) = 0;
/*[helpstring("Set loading mode of list")]*/
STDMETHOD(SetLoadMode)(/*[in]*/ BOOL bState) = 0;
/*[helpstring("Arrange the icons in the result pane")]*/
STDMETHOD(Arrange)(long style) = 0;
/*[helpstring("Sort from the Listview header control")]*/
STDMETHOD(InternalSort)(INT nCol, DWORD dwSortOptions, LPARAM lUserParam, BOOL bColumnClicked) = 0;
/*[helpstring("Private tree control method used to reset the result view")]*/
STDMETHOD(ResetResultData)() = 0;
/*[helpstring("Private listview method to retrieve sort column")]*/
STDMETHOD(GetSortColumn)(INT* pnCol) = 0;
/*[helpstring("Private listview method to retrieve sort column")]*/
STDMETHOD(GetSortDirection)(BOOL* pbAscending) = 0;
};
// helpstring("IHeaderCtrlPrivate Interface that adds to IHeaderCtrl methods"),
MMC_INTERFACE(IHeaderCtrlPrivate, 0B384311-701B-4e8a-AEC2-DA6321E27AD2) : IHeaderCtrl2
{
/*[helpstring("Get the number of columns in list view.")]*/
STDMETHOD(GetColumnCount)(/*[in]*/INT* pnCol) = 0;
/*[helpstring("Get the current column settings from list view header.")]*/
STDMETHOD(GetColumnInfoList)(/*[out]*/ CColumnInfoList *pColumnsList) = 0;
/*[helpstring("Modify the columns in list view with given data.")]*/
STDMETHOD(ModifyColumns)(/*[in]*/ const CColumnInfoList& columnsList) = 0;
/*[helpstring("Get the column settings that snapin supplied originally")]*/
STDMETHOD(GetDefaultColumnInfoList)(/*[out]*/ CColumnInfoList& columnsList) = 0;
};
// helpstring("Minimum master tree control methods required by node manager."),
MMC_INTERFACE(IScopeTree, d8dbf067-5fb2-11d0-a986-00c04fd8d565) : IUnknown
{
/*[helpstring("Initialize scope tree with the document.")]*/
STDMETHOD(Initialize)(/*[in]*/ HWND hFrameWindow, /*[in]*/ IStringTablePrivate* pStringTable) = 0;
/*[helpstring("Query for an iterator to the master tree items.")]*/
STDMETHOD(QueryIterator)(/*[out]*/IScopeTreeIter** lpIter) = 0;
/*[helpstring("Query for an node callback interface to access HNODE items.")]*/
STDMETHOD(QueryNodeCallback)(/*[out]*/ INodeCallback** ppNodeCallback) = 0;
/*[helpstring("Create a node from the master tree node.")]*/
STDMETHOD(CreateNode)(/*[in]*/ HMTNODE hMTNode, /*[in]*/ LONG_PTR lViewData,
/*[in]*/ BOOL fRootNode, /*[out]*/ HNODE* phNode) = 0;
/*[helpstring("Do cleanup needed prior to deleting/shutting down view.")]*/
STDMETHOD(CloseView)(/*[in]*/ int nView) = 0;
/*[helpstring("Delete all view data for the specified view id.")]*/
STDMETHOD(DeleteView)(/*[in]*/ int nView) = 0;
/*[helpstring("Create a node from the master tree node.")]*/
STDMETHOD(DestroyNode)(/*[in]*/ HNODE hNode) = 0;
/*[helpstring("Finds the node that matches the ID")]*/
STDMETHOD(Find)(/*[in]*/ MTNODEID mID, /*[out]*/ HMTNODE* phMTNode) = 0;
/*[helpstring("Create a node from the master tree node.")]*/
STDMETHOD(GetImageList)(/*[out]*/ PLONG_PTR plImageList) = 0;
/*[helpstring("Run snap-in manager")]*/
STDMETHOD(RunSnapIn)(/*[in]*/ HWND hwndParent) = 0;
/*[helpstring("Returns the version for the file rooted at the given storage.")]*/
STDMETHOD(GetFileVersion)(/*[in]*/ IStorage* pstgRoot, /*[out]*/ int* pnVersion) = 0;
/*[helpstring("Returns the MTNODEID for the node represented by a bookmark")]*/
STDMETHOD(GetNodeIDFromBookmark)(/*[in]*/ HBOOKMARK hbm, /*[out]*/ MTNODEID* pID, /*[out]*/ bool& bExactMatchFound) = 0;
/*[helpstring("Loads a bookmark from a stream and returns the MTNODEID for the node.")]*/
STDMETHOD(GetNodeIDFromStream)(/*[in]*/ IStream *pStm, /*[out]*/ MTNODEID* pID) = 0;
/*[helpstring("Loads a bookmark from a stream and returns the MTNODEID for the node.")]*/
STDMETHOD(GetNodeFromBookmark)(/*[in]*/ HBOOKMARK hbm, /*[in]*/CConsoleView *pConsoleView, /*[out]*/ PPNODE ppNode, /*[out]*/ bool& bExactMatchFound) = 0;
/*[helpstring("Returns the ID path for the given ID")]*/
STDMETHOD(GetIDPath)(/*[in]*/ MTNODEID id, /*[out]*/ MTNODEID** ppIDs, /*[out]*/ long* pLength) = 0;
/*[helpstring("Check to see if synchronous node expansion is required")]*/
STDMETHOD(IsSynchronousExpansionRequired)() = 0;
/*[helpstring("Sets whether synchronous node expansion is required")]*/
STDMETHOD(RequireSynchronousExpansion)(/*[in]*/ BOOL fRequireSyncExpand) = 0;
/*[helpstring("Sets the SConsoleData to use for this scope tree")]*/
STDMETHOD(SetConsoleData)(/*[in]*/ LPARAM lConsoleData) = 0;
/*[helpstring("Persists the tree to/from an XML document")]*/
STDMETHOD(Persist)(/*[in]*/ HPERSISTOR hPersistor) = 0;
/*[helpstring("Get path between two nodes as a string")]*/
STDMETHOD(GetPathString)(/*[in]*/ HMTNODE hmtnRoot, /*[in]*/ HMTNODE hmtnLeaf, /*[out]*/ LPOLESTR* pPath) = 0;
/*[helpstring("Get the SnapIns object")]*/
STDMETHOD(QuerySnapIns)(/*[out]*/ SnapIns **ppSnapIns) = 0;
/*[helpstring("Get the ScopeNamespace object")]*/
STDMETHOD(QueryScopeNamespace)(/*[out]*/ ScopeNamespace **ppScopeNamespace) = 0;
/*[helpstring("Create an empty Properties object")]*/
STDMETHOD(CreateProperties)(/*[out]*/ Properties **ppProperties) = 0;
/*[helpstring("Get scope node id for Node object")]*/
STDMETHOD(GetNodeID)(/*[in]*/ PNODE pNode, /*[out]*/ MTNODEID *pID) = 0;
/*[helpstring("Get HMTNODE for Node object")]*/
STDMETHOD(GetHMTNode)(/*[in]*/ PNODE pNode, /*[out]*/ HMTNODE *phMTNode) = 0;
/*[helpstring("Get Node object ptr for scope node")]*/
STDMETHOD(GetMMCNode)(/*[in]*/ HMTNODE hMTNode, /*[out]*/ PPNODE ppNode) = 0;
/*[helpstring("Get NODE object for Root Node")]*/
STDMETHOD(QueryRootNode)(/*[out]*/ PPNODE ppNode) = 0;
/*[helpstring("Check if snapin is used by MMC")]*/
STDMETHOD(IsSnapinInUse)(/*[in]*/ REFCLSID refClsidSnapIn, /*[out]*/ PBOOL pbInUse) = 0;
};
// helpstring("Master tree item iterator."),
MMC_INTERFACE(IScopeTreeIter, d779f8d1-6057-11d0-a986-00c04fd8d565) : IUnknown
{
/*[helpstring("Sets the current master tree node.")]*/
STDMETHOD(SetCurrent)(/*[in]*/ HMTNODE hStartMTNode) = 0;
/*[helpstring("Returns the next nRequested master node siblings.")]*/
STDMETHOD(Next)(/*[in]*/ UINT nRequested, /*[out]*/ HMTNODE* rghScopeItems, /*[out]*/ UINT* pnFetched) = 0;
/*[helpstring("Returns the child master node.")]*/
STDMETHOD(Child)(/*[out]*/ HMTNODE* phsiChild) = 0;
/*[helpstring("Returns the parent master node.")]*/
STDMETHOD(Parent)(/*[out]*/ HMTNODE* phsiParent) = 0;
};
// helpstring("Node callback methods."),
MMC_INTERFACE(INodeCallback, b241fced-5fb3-11d0-a986-00c04fd8d565) : IUnknown
{
/*[helpstring("Initialize with the scope tree.")]*/
STDMETHOD(Initialize)(/*[in]*/ IScopeTree* pIScopeTree) = 0;
/*[helpstring("Returns the images for this node.")]*/
STDMETHOD(GetImages)(/*[in]*/ HNODE hNode, /*[out]*/ int* iImage, int* iSelectedImage) = 0;
/*[helpstring("Returns the display name for node.")]*/
STDMETHOD(GetDisplayName)(/*[in]*/ HNODE hNode, /*[out]*/ tstring& strName) = 0;
/*[helpstring("Returns the custom window title for this node")]*/
STDMETHOD(GetWindowTitle)(/*[in]*/ HNODE hNode, /*[out]*/ tstring& strTitle) = 0;
/*[helpstring("Handles callback for result items")]*/
STDMETHOD(GetDispInfo)(/*[in]*/ HNODE hNode, /*[in,out]*/ LVITEMW* plvi) = 0;
/*[helpstring("Returns the UI state of master node.")]*/
STDMETHOD(GetState)(/*[in]*/ HNODE hNode, /*[out]*/ UINT* pnState) = 0;
/*[helpstring("Returns the result pane for the node.")]*/
STDMETHOD(GetResultPane)(/*[in]*/ HNODE hNode, /*[in, out]*/ CResultViewType& rvt,
/*[out]*/ GUID *pGuidTaskpadID) = 0;
/*[helpstring("Asks the snapin to restore its result pane with given data")]*/
STDMETHOD(RestoreResultView)(/*[in]*/HNODE hNode, /*[in]*/const CResultViewType& rvt) = 0;
/*[helpstring("Returns the result pane OCX control for the node.")]*/
STDMETHOD(GetControl)(/*[in]*/ HNODE hNode, /*[in]*/ CLSID clsid, /*[out]*/IUnknown **ppUnkControl) = 0;
/*[helpstring("Sets the result pane OCX control for the node.")]*/
STDMETHOD(SetControl)(/*[in]*/ HNODE hNode, /*[in]*/ CLSID clsid, /*[in]*/IUnknown* pUnknown) = 0;
/*[helpstring("Returns the result pane OCX control for the node.")]*/
STDMETHOD(GetControl)(/*[in]*/ HNODE hNode, /*[in]*/LPUNKNOWN pUnkOCX, /*[out]*/IUnknown **ppUnkControl) = 0;
/*[helpstring("Sets the result pane OCX control for the node.")]*/
STDMETHOD(SetControl)(/*[in]*/ HNODE hNode, /*[in]*/LPUNKNOWN pUnkOCX, /*[in]*/IUnknown* pUnknown) = 0;
/*[helpstring("Sends the MMCN_INITOCX notification to the appropriate snapin")]*/
STDMETHOD(InitOCX)(/*[in]*/ HNODE hNode, /*[in]*/ IUnknown* pUnknown) = 0;
/*[helpstring("Set the Result Item ID")]*/
//RENAME// STDMETHOD(SetItemID)(/*[in]*/ HNODE hNode, /*[in]*/ HRESULTITEM riID) = 0;
STDMETHOD(SetResultItem)(/*[in]*/ HNODE hNode, /*[in]*/ HRESULTITEM hri) = 0;
/*[helpstring("Get the Result Item ID")]*/
//RENAME// STDMETHOD(GetItemID)(/*[in]*/ HNODE hNode, /*[out]*/ HRESULTITEM* priID) = 0;
STDMETHOD(GetResultItem)(/*[in]*/ HNODE hNode, /*[out]*/ HRESULTITEM* phri) = 0;
/*[helpstring("Returns the nodes unique ID")]*/
//RENAME// STDMETHOD(GetID)(/*[in]*/ HNODE hNode, /*[out]*/ MTNODEID* pnID) = 0;
STDMETHOD(GetMTNodeID)(/*[in]*/ HNODE hNode, /*[out]*/ MTNODEID* pnID) = 0;
/*[helpstring("Determine if node is the target of another")]*/
STDMETHOD(IsTargetNodeOf)(/*[in]*/ HNODE hNode, /*[in]*/ HNODE hTestNode) = 0;
/*[helpstring("Returns the nodes static parents MTNODEID and the subsequent path")]*/
STDMETHOD(GetPath)(/*[in]*/ HNODE hNode, /*[in]*/ HNODE hRootNode, /*[out]*/ BYTE* pbm_) = 0;
/*[helpstring("Returns the static parent nodes unique ID")]*/
STDMETHOD(GetStaticParentID)(/*[in]*/ HNODE hNode, /*[out]*/ MTNODEID* pnID) = 0;
/*[helpstring("Notify")]*/
STDMETHOD(Notify)(/*[in]*/ HNODE hNode, /*[in]*/ NCLBK_NOTIFY_TYPE event,
/*[in]*/ LPARAM arg, /*[in]*/ LPARAM param) = 0;
/*[helpstring("Returns the parent master node.")]*/
STDMETHOD(GetMTNode)(/*[in]*/ HNODE hNode, /*[out]*/ HMTNODE* phMTNode) = 0;
/*[helpstring("The HMTNODE path to the node is returned in pphMTNode")]*/
STDMETHOD(GetMTNodePath)(/*[in]*/ HNODE hNode, /*[out]*/ HMTNODE** pphMTNode,
/*[out]*/ long* plLength) = 0;
/*[helpstring("Get node's owner ID")]*/
STDMETHOD(GetNodeOwnerID)(/*[in]*/ HNODE hNode, /*[out]*/ COMPONENTID* pID) = 0;
/*[helpstring("Get node's cookie")]*/
STDMETHOD(GetNodeCookie)(/*[in]*/ HNODE hNode, /*[out]*/ MMC_COOKIE* lpCookie) = 0;
/*[helpstring("Returns S_OK if the node can possibly be expanded, and S_FALSE otherwise.")]*/
STDMETHOD(IsExpandable)(/*[in]*/ HNODE hNode) = 0;
/*[helpstring("Return the dataobject for the selected item")]*/
// cookie valid if bScope & bMultiSel are both FALSE.
// cookie is the index\lParam for virtual\regular LV
STDMETHOD(GetDragDropDataObject)(/*[in]*/ HNODE hNode, /*[in]*/ BOOL bScope, /*[in]*/ BOOL bMultiSel,
/*[in]*/ LONG_PTR lvData, /*[out]*/ LPDATAOBJECT* ppDataObject,
/*[out]*/ bool& bCopyAllowed, /*[out]*/ bool& bMoveAllowed) = 0;
/*[helpstring("Returns the task enumerator.")]*/
STDMETHOD(GetTaskEnumerator)(/*[in]*/ HNODE hNode, /*[in]*/ LPCOLESTR pszTaskGroup,
/*[out]*/ IEnumTASK** ppEnumTask) = 0;
/*[helpstring("UpdateWindowLayout.")]*/
STDMETHOD(UpdateWindowLayout)(/*[in]*/ LONG_PTR lViewData, /*[in]*/ long lToolbarsDisplayed) = 0;
/*[helpstring("AddCustomFolderImage")]*/
STDMETHOD(AddCustomFolderImage)(/*[in]*/ HNODE hNode,
/*[in]*/ IImageListPrivate* pImageList) = 0;
/*[helpstring("preloads the node if necessary")]*/
STDMETHOD(PreLoad)(/*[in]*/ HNODE hNode) = 0;
/*[helpstring("Get the TaskPad ListView information")]*/
STDMETHOD(GetListPadInfo)(/*[in]*/ HNODE hNode,
/*[in]*/ IExtendTaskPad* pExtendTaskPad,
/*[in,string]*/ LPCOLESTR szTaskGroup,
/*[out]*/ MMC_ILISTPAD_INFO* pIListPadInfo) = 0;
/*[helpstring("Sets Task Pads list view")]*/
STDMETHOD(SetTaskPadList)(/*[in]*/ HNODE hNode, /*[in]*/ LPUNKNOWN pUnknown) = 0;
/*[helpstring("Sets up a specific taskpad, given the GUID identifier.")]*/
STDMETHOD(SetTaskpad)(/*[in]*/ HNODE hNodeSelected, /*[in]*/ GUID *pGuidTaskpad) = 0;
/*[helpstring("Invokes the Customize View dialog")]*/
STDMETHOD(OnCustomizeView)(/*[in]*/ LONG_PTR lViewData) = 0;
/*[helpstring("Set the view settings for a particular node.")]*/
STDMETHOD(SetViewSettings)(/*[in]*/ int nViewID, /*[in]*/ HBOOKMARK hbm, /*[in]*/ HVIEWSETTINGS hvs) = 0;
/*[helpstring("Execute given verb for given scope item")]*/
STDMETHOD(ExecuteScopeItemVerb)(/*[in]*/ MMC_CONSOLE_VERB verb, /*[in]*/ HNODE hNode, /*[in]*/LPOLESTR lpszNewName) = 0;
/*[helpstring("Execute given verb for selected result item(s)")]*/
STDMETHOD(ExecuteResultItemVerb)(/*[in]*/ MMC_CONSOLE_VERB verb, /*[in]*/ HNODE hNode, /*[in]*/LPARAM lvData, /*[in]*/LPOLESTR lpszNewName) = 0;
/*[helpstring("Get the disp interface for given scope node object")]*/
STDMETHOD(QueryCompDataDispatch)(/*[in]*/ PNODE pNode, /*[out]*/ PPDISPATCH ScopeNodeObject) = 0;
/*[helpstring("Get the disp interface for selected resultpane objects")]*/
STDMETHOD(QueryComponentDispatch)(/*[in]*/ HNODE hNode, /*[in]*/LPARAM lvData, /*[out]*/ PPDISPATCH SelectedObject) = 0;
/*[helpstring("Creates a context menu for the specified node.")]*/
STDMETHOD(CreateContextMenu)( PNODE pNode, HNODE hNode, PPCONTEXTMENU ppContextMenu) = 0;
/*[helpstring("Creates a context menu for the current selection node.")]*/
STDMETHOD(CreateSelectionContextMenu)( HNODE hNodeScope, CContextMenuInfo *pContextInfo, PPCONTEXTMENU ppContextMenu) = 0;
/*[helpstring("show/hide column")]*/
STDMETHOD(ShowColumn)(HNODE hNodeSelected, int iColIndex, bool bShow) = 0;
/*[helpstring("to get the sort column")]*/
STDMETHOD(GetSortColumn)(HNODE hNodeSelected, int *piSortCol) = 0;
/*[helpstring("to set the sort column")]*/
STDMETHOD(SetSortColumn)(HNODE hNodeSelected, int iSortCol, bool bAscending) = 0;
/*[helpstring("Returns the data for the specified clipboard format of the specified list item")*/
STDMETHOD(GetProperty)(/*[in]*/ HNODE hNodeScope, /*[in]*/ BOOL bForScopeItem, /*[in]*/ LPARAM resultItemParam, /*[in]*/ BSTR bstrPropertyName,
/*[out]*/ PBSTR pbstrPropertyValue) =0;
/*[helpstring("Returns the nodetype GUID identifier of the specified list item")*/
STDMETHOD(GetNodetypeForListItem)(/*[in]*/ HNODE hNodeScope, /*[in]*/ BOOL bForScopeItem, /*[in]*/ LPARAM resultItemParam, /*[in]*/ PBSTR pbstrNodetype) =0;
/* returns view extension by inserting them to provided iterator */
STDMETHOD(GetNodeViewExtensions)(/*[in]*/ HNODE hNodeScope, /*[out]*/ CViewExtInsertIterator it) = 0;
/* Inform nodemgr that the column data for given node has changed & to save the data */
STDMETHOD(SaveColumnInfoList) (/*[in]*/HNODE hNode, /*[in]*/const CColumnInfoList& columnsList) = 0;
/* Ask nodemgr for column-data (no sort data) to setup the headers. */
STDMETHOD(GetPersistedColumnInfoList) (/*[in]*/HNODE hNode, /*[out]*/CColumnInfoList *pColumnsList) = 0;
/* Inform nodemgr that the column data for given node is invalid. */
STDMETHOD(DeletePersistedColumnData) (/*[in]*/HNODE hNode) = 0;
/* Does about object exists for the snapin whose node is provided. */
STDMETHOD(DoesAboutExist) (/*[in]*/HNODE hNode, /*[out]*/ bool *pbAboutExists) = 0;
/* Show about box for given context. */
STDMETHOD(ShowAboutInformation) (/*[in]*/HNODE hNode) = 0;
/*Executes a shell command with the specified parameters in the specified directory with the correct window size*/
STDMETHOD(ExecuteShellCommand)(/*[in]*/ HNODE hNode, /*[in]*/ BSTR Command, /*[in]*/ BSTR Directory, /*[in]*/ BSTR Parameters, /*[in]*/ BSTR WindowState) = 0;
/*Given the context update the paste button.*/
STDMETHOD(UpdatePasteButton)(/*[in]*/ HNODE hNode, /*[in]*/ BOOL bScope, /*[in]*/ LPARAM lCookie) = 0;
/*Findout if current selection context can allow given dataobject to be pasted.*/
STDMETHOD(QueryPaste)(/*[in]*/ HNODE hNode, /*[in]*/ BOOL bScope, /*[in]*/ LPARAM lCookie, /*[in]*/ IDataObject *pDataObject, /*[out]*/bool& bPasteAllowed, /*[out]*/ bool& bCopyOperatationIsDefault) = 0;
/*Findout if current selection context can allow given dataobject to be pasted.*/
STDMETHOD(QueryPasteFromClipboard)(/*[in]*/ HNODE hNode, /*[in]*/ BOOL bScope, /*[in]*/ LPARAM lCookie, /*[out]*/bool& bPasteAllowed) = 0;
/*Given the current drop target (or paste target) context paste the given data object or the one from clipboard*/
STDMETHOD(Drop) (/*[in]*/HNODE hNode, /*[in]*/BOOL bScope, /*[in]*/LPARAM lCookie, /*[in]*/IDataObject *pDataObjectToPaste, /*[in]*/BOOL bIsDragOperationMove) = 0;
/*Given the current drop target (or paste target) context paste the given data object or the one from clipboard*/
STDMETHOD(Paste) (/*[in]*/HNODE hNode, /*[in]*/BOOL bScope, /*[in]*/LPARAM lCookie) = 0;
/*Get the IPersistStream of the CViewSettingsPersistor object for loading the settings.*/
STDMETHOD(QueryViewSettingsPersistor) (/*[out]*/IPersistStream** ppStream) = 0;
/*Get the IXMLObject of the CViewSettingsPersistor object for storing/loading the settings.*/
STDMETHOD(QueryViewSettingsPersistor) (/*[out]*/CXMLObject** ppXMLObject) = 0;
/*Inform nodemgr that the document is closing, do any cleanups.*/
STDMETHOD(DocumentClosing) () = 0;
// Given the node get the snapin name
STDMETHOD(GetSnapinName)(/*[in]*/HNODE hNode, /*[out]*/LPOLESTR* ppszName, /*[out]*/ bool& bValidName) = 0;
// Given the node see if it is dummy snapin
STDMETHOD(IsDummySnapin)(/*[in]*/HNODE hNode, /*[out]*/bool& bDummySnapin) = 0;
// See if the snapin supports MMC1.0 version of help (MMCN_SNAPINHELP)
STDMETHOD(DoesStandardSnapinHelpExist)(/*[in]*/HNODE hNode, /*[out]*/bool& bStandardHelpExists) = 0;
};
// helpstring("IControlbarsCache Interface"),
MMC_INTERFACE(IControlbarsCache, 2e9fcd38-b9a0-11d0-a79d-00c04fd8d565) : IUnknown
{
/*[helpstring("Detaches all the controlbars.")]*/
STDMETHOD(DetachControlbars)() = 0;
};
typedef enum _EXTESION_TYPE
{
EXTESION_NAMESPACE = 0x1,
EXTESION_CONTEXTMENU = 0x2,
EXTESION_TOOLBAR = 0x3,
EXTESION_PROPERTYSHEET = 0x4,
} EXTESION_TYPE;
// helpstring("INodeType Interface"),
MMC_INTERFACE(INodeType, B08A8368-967F-11D0-A799-00C04FD8D565) : IUnknown
{
STDMETHOD(GetNodeTypeID)(/*[out]*/ GUID* pGUID) = 0;
STDMETHOD(AddExtension)(/*[in]*/ GUID guidSnapIn,
/*[in]*/ EXTESION_TYPE extnType) = 0;
STDMETHOD(RemoveExtension)(/*[in]*/ GUID guidSnapIn,
/*[in]*/ EXTESION_TYPE extnType) = 0;
STDMETHOD(EnumExtensions)(/*[in]*/ EXTESION_TYPE extnType,
/*[out]*/ IEnumGUID** ppEnumGUID) = 0;
};
// helpstring("INodeTypesCache Interface"),
MMC_INTERFACE(INodeTypesCache, DE40436E-9671-11D0-A799-00C04FD8D565) : IUnknown
{
STDMETHOD(CreateNodeType)(/*[in]*/ GUID guidNodeType,
/*[out]*/ INodeType** ppNodeType) = 0;
STDMETHOD(DeleteNodeType)(/*[in]*/ GUID guidNodeType) = 0;
STDMETHOD(EnumNodeTypes)(/*[out]*/ IEnumNodeTypes** ppEnumNodeTypes) = 0;
};
MMC_INTERFACE(IEnumNodeTypes, ABBD61E6-9686-11D0-A799-00C04FD8D565) : IUnknown
{
STDMETHOD(Next)(/*[in]*/ ULONG celt,
/*[out, size_is(celt), length_is(*pceltFetched)]*/ INodeType*** rgelt,
/*[out]*/ ULONG *pceltFetched) = 0;
STDMETHOD(Skip)(/*[in]*/ ULONG celt) = 0;
STDMETHOD(Reset)() = 0;
STDMETHOD(Clone)(/*[out]*/ IEnumNodeTypes **ppenum) = 0;
};
class CBasicSnapinInfo
{
public:
CBasicSnapinInfo() : m_clsid(GUID_NULL), m_nImageIndex(-1) {}
public:
CLSID m_clsid;
std::wstring m_strName;
int m_nImageIndex;
};
class CAvailableSnapinInfo
{
public:
CAvailableSnapinInfo (bool f32Bit) : m_cTotalSnapins(0), m_himl(NULL), m_f32Bit(f32Bit) {}
~CAvailableSnapinInfo()
{
if (m_himl != NULL)
ImageList_Destroy (m_himl);
}
public:
std::vector<CBasicSnapinInfo> m_vAvailableSnapins; // snap-ins that are available in the requested memory model
UINT m_cTotalSnapins; // total number of snap-ins referenced in the console file
HIMAGELIST m_himl; // images for snap-ins in m_vAvailableSnapins
const bool m_f32Bit; // check 32-bit (vs. 64-bit) snap-ins?
};
// helpstring("IDumpSnapins Interface"),
MMC_INTERFACE(IDumpSnapins, A16496D0-1D2F-11d3-AEB8-00C04F8ECD78) : IUnknown
{
STDMETHOD(Dump)(/*[in]*/ LPCTSTR pszDumpFilePath) = 0;
STDMETHOD(CheckSnapinAvailability)(/*[in/out]*/ CAvailableSnapinInfo& asi) = 0;
};
MMC_INTERFACE(IPropertySheetProviderPrivate, FEF554F8-A55A-11D0-A7D7-00C04FD909DD) : IPropertySheetProvider
{
STDMETHOD(ShowEx)(/*[in]*/ HWND hwnd, /*[in]*/ int page, /*[in]*/ BOOL bModalPage) = 0;
STDMETHOD(CreatePropertySheetEx)(
/*[in]*/ LPCWSTR title,
/*[in]*/ boolean type,
/*[in]*/ MMC_COOKIE cookie,
/*[in]*/ LPDATAOBJECT pIDataObject,
/*[in]*/ LONG_PTR lpMasterTreeNode,
/*[in]*/ DWORD dwOptions) = 0;
/*[helpstring("Collects the pages from the extension snap-in(s)")]*/
STDMETHOD(AddMultiSelectionExtensionPages)(LONG_PTR lMultiSelection) = 0;
/*[helpstring("Determine if the property sheet exist")]*/
STDMETHOD(FindPropertySheetEx)(/*[in]*/ MMC_COOKIE cookie, /*[in]*/ LPCOMPONENT lpComponent,
/*[in]*/ LPCOMPONENTDATA lpComponentData, /*[in]*/ LPDATAOBJECT lpDataObject) = 0;
/*[helpstring("Set data required for property sheet tooltips")]*/
STDMETHOD(SetPropertySheetData)(/*[in]*/ INT nPropSheetType, /*[in]*/ HMTNODE hMTNode) = 0;
};
const long CCLV_HEADERPAD = 25;
// helpstring("MMC Default listview interface"),
MMC_INTERFACE(IMMCListView, 1B3C1392-D68B-11CF-8C2B-00AA003CA9F6) : IUnknown
{
STDMETHOD(GetListStyle)( void ) = 0;
STDMETHOD(SetListStyle)(
/*[in]*/ long nNewValue ) = 0;
STDMETHOD(GetViewMode)( void ) = 0;
STDMETHOD(SetViewMode)(
/*[in]*/ long nViewMode ) = 0;
STDMETHOD(InsertItem)(
/*[in]*/ LPOLESTR str,
/*[in]*/ long iconNdx,
/*[in]*/ LPARAM lParam,
/*[in]*/ long state,
/*[in]*/ long ownerID,
/*[in]*/ long itemIndex,
/*[out]*/ CResultItem*& pri) = 0;
/* parameter changed to HRESULTITEM, not to use the CResultItem*
pointer until we know it is not a virtual list */
STDMETHOD(DeleteItem)(
/*[in]*/ HRESULTITEM itemID,
/*[in]*/ long nCol) = 0;
STDMETHOD(FindItemByLParam)(
/*[in]*/ long owner,
/*[in]*/ LPARAM lParam,
/*[out]*/ CResultItem*& pri) = 0;
STDMETHOD(InsertColumn)(
/*[in]*/ int nCol,
/*[in]*/ LPCOLESTR str,
/*[in]*/ long nFormat,
/*[in]*/ long width) = 0;
STDMETHOD(DeleteColumn)(
/*[in]*/ int nCol) = 0;
STDMETHOD(DeleteAllItems)(
/*[in]*/ long ownerID) = 0;
STDMETHOD(SetColumn)(
/*[in]*/ long nCol,
/*[in]*/ LPCOLESTR str,
/*[in]*/ long nFormat,
/*[in]*/ long width) = 0;
STDMETHOD(GetColumn)(
/*[in]*/ long nCol,
/*[out]*/ LPOLESTR* str,
/*[out]*/ long* nFormat,
/*[out]*/ int* width) = 0;
STDMETHOD(GetColumnCount)(
/*[out]*/ int* nColCnt) = 0;
STDMETHOD(SetItem)(
/*[in]*/ int nIndex,
/*[in]*/ CResultItem* pri,
/*[in]*/ long nCol,
/*[in]*/ LPOLESTR str,
/*[in]*/ long nImage,
/*[in]*/ LPARAM lParam,
/*[in]*/ long nState,
/*[in]*/ long ownerID) = 0;
STDMETHOD(GetItem)(
/*[in]*/ int nIndex,
/*[in]*/ CResultItem*& pri,
/*[in]*/ long nCol,
/*[out]*/ LPOLESTR* str,
/*[out]*/ int* nImage,
/*[in]*/ LPARAM* lParam,
/*[out]*/ unsigned int* nState,
/*[out]*/ BOOL* pbScopeItem) = 0;
STDMETHOD(GetNextItem)(
/*[in]*/ COMPONENTID ownerID,
/*[in]*/ long nIndex,
/*[in]*/ UINT nState,
/*[out]*/ CResultItem*& ppListItem,
/*[out]*/ long& nIndexNextItem) = 0;
STDMETHOD(GetLParam)(
/*[in]*/ long nItem,
/*[out]*/ CResultItem*& pri) = 0;
STDMETHOD(ModifyItemState)(
/*[in]*/ long nItem,
/*[in]*/ CResultItem* pri,
/*[in]*/ UINT add,
/*[in]*/ UINT remove) = 0;
STDMETHOD(SetIcon)(
/*[in]*/ long nID,
/*[in]*/ HICON hIcon,
/*[in]*/ long nLoc) = 0;
STDMETHOD(SetImageStrip)(
/*[in]*/ long nID,
/*[in]*/ HBITMAP hbmSmall,
/*[in]*/ HBITMAP hbmLarge,
/*[in]*/ long nStartLoc,
/*[in]*/ long cMask) = 0;
STDMETHOD(MapImage)(
/*[in]*/ long nID,
/*[in]*/ long nLoc,
/*[out]*/ int* pResult) = 0;
STDMETHOD(Reset)() = 0;
STDMETHOD(Arrange)(/*[in]*/ long style) = 0;
STDMETHOD(UpdateItem)(/*[in]*/HRESULTITEM itemID) = 0;
STDMETHOD(Sort)(
/*[in]*/ LPARAM lUserParam,
/*[in]*/ long* pParams) = 0;
STDMETHOD(SetItemCount)(
/*[in]*/ int nItemCount,
/*[in]*/ DWORD dwOptions) = 0;
STDMETHOD(SetVirtualMode)(
/*[in]*/ BOOL bVirtual) = 0;
STDMETHOD(Repaint)(
/*[in]*/ BOOL bErase) = 0;
STDMETHOD(SetChangeTimeOut)(
/*[in]*/ ULONG lTimeout) = 0;
STDMETHOD(SetColumnFilter)(
/*[in]*/ int nCol,
/*[in]*/ DWORD dwType,
/*[in]*/ MMC_FILTERDATA* pFilterData) = 0;
STDMETHOD(GetColumnFilter)(
/*[in]*/ int nCol,
/*[in,out]*/ DWORD* dwType,
/*[in,out]*/ MMC_FILTERDATA* pFilterData) = 0;
STDMETHOD(SetColumnSortIcon)(
/*[in]*/ int nNewCol,
/*[in]*/ int nOldCol,
/*[in]*/ BOOL bAscending,
/*[in]*/ BOOL bSetSortIcon) = 0;
STDMETHOD(SetLoadMode)(
/*[in]*/ BOOL bState) = 0;
/*[helpstring("Get the current list view header settings.")]*/
STDMETHOD(GetColumnInfoList) (/*[out]*/CColumnInfoList *pColumnsList) = 0;
/*[helpstring("Modify the list-view headers with given data.")]*/
STDMETHOD(ModifyColumns) (/*[in]*/const CColumnInfoList& columnsList) = 0;
/* Put the specified list item into rename mode */
STDMETHOD(RenameItem) ( /*[in]*/HRESULTITEM itemID) =0;
/*[helpstring("Get the column settings that snapin supplied originally")]*/
STDMETHOD(GetDefaultColumnInfoList)(/*[out]*/ CColumnInfoList& columnsList) = 0;
};
///////////////////////////////////////////////////////////////////////////////
///////////////////////////////////////////////////////////////////////////////
///////////////////////////////////////////////////////////////////////////////
///////////////////////////////////////////////////////////////////////////////
////
//// MMC 1.1 changes
////
// MMC_ITASK, internal form of MMC_TASK has additional field for classid.
struct MMC_ITASK
{
MMC_TASK task;
LPOLESTR szClsid;
};
// helpstring("Console <=> CIC communication conduit"),
MMC_INTERFACE(ITaskPadHost, 4f7606d0-5568-11d1-9fea-00600832db4a) : IUnknown
{
/*[helpstring("CIC calls this when snapin's script wants to notify the snapin of something")]*/
STDMETHOD(TaskNotify)(/*[in,string]*/ BSTR szClsid, /*[in]*/ VARIANT * pvArg, /*[in]*/ VARIANT * pvParam) = 0;
/*[helpstring("CIC calls this when the script asks for tasks")]*/
STDMETHOD(GetTaskEnumerator)(/*[in]*/ BSTR szTaskGroup, /*[out]*/ IEnumTASK** ppEnumTASK) = 0;
/*[helpstring("Returns the primary snapins IExtendTaskPad")]*/
STDMETHOD(GetPrimaryTask)(/*[out]*/ IExtendTaskPad** ppExtendTaskPad) = 0;
/*[helpstring("Returns the primary snapin's taskpad title")]*/
STDMETHOD(GetTitle)(/*[in]*/ BSTR szTaskGroup, /*[out]*/ BSTR * szTitle) = 0;
/*[helpstring("Descriptive Text for the default task pad.")]*/
STDMETHOD(GetDescriptiveText)(/*[in,string]*/ BSTR pszGroup, /*[out]*/ BSTR * pszDescriptiveText) = 0;
/*[helpstring("Returns the primary snapin's taskpad background image.")]*/
STDMETHOD(GetBackground)(/*[in]*/ BSTR szTaskGroup, /*[out]*/ MMC_TASK_DISPLAY_OBJECT * pTDO) = 0;
// /*[helpstring("Returns the primary snapin's taskpad branding info.")]*/
// STDMETHOD(GetBranding)(/*[in,string]*/ BSTR szGroup, /*[out]*/ MMC_TASK_DISPLAY_OBJECT * pTDO) = 0;
/*[helpstring("Returns the primary snapin's listpad info")]*/
STDMETHOD(GetListPadInfo)(/*[in]*/ BSTR szTaskGroup, /*[out]*/ MMC_ILISTPAD_INFO * pIListPadInfo) = 0;
};
// helpstring("Interface for accessing strings in a console file"),
MMC_INTERFACE(IStringTablePrivate, 461A6010-0F9E-11d2-A6A1-0000F875A9CE) : IUnknown
{
/*[helpstring("Add a string to the snap-in's string table")]*/
STDMETHOD(AddString)(
/*[in]*/ LPCOLESTR pszAdd, // string to add to the string table
/*[out]*/ MMC_STRING_ID* pStringID, // ID of added string
/*[in]*/ const CLSID * pCLSID // CLSID of owner (NULL for MMC)
) = 0;
/*[helpstring("Retrieves a string from the snap-in's string table")]*/
STDMETHOD(GetString)(
/*[in]*/ MMC_STRING_ID StringID, // ID of string
/*[in]*/ ULONG cchBuffer, // number of characters in lpBuffer
/*[out, size_is(cchBuffer)]*/
LPOLESTR lpBuffer, // string corresponding to wStringID
/*[out]*/ ULONG* pcchOut, // number of characters written to lpBuffer
/*[in]*/ const CLSID * pCLSID // CLSID of owner (NULL for MMC)
) = 0;
/*[helpstring("Retrieves the length of a string in the snap-in's string table")]*/
STDMETHOD(GetStringLength)(
/*[in]*/ MMC_STRING_ID StringID, // ID of string
/*[out]*/ ULONG* pcchString, // number of characters in string, not including terminator
/*[in]*/ const CLSID * pCLSID // CLSID of owner (NULL for MMC)
) = 0;
/*[helpstring("Delete a string from the snap-in's string table")]*/
STDMETHOD(DeleteString)(
/*[in]*/ MMC_STRING_ID StringID, // ID of string to delete
/*[in]*/ const CLSID * pCLSID // CLSID of owner (NULL for MMC)
) = 0;
/*[helpstring("Delete all strings from the snap-in's string table")]*/
STDMETHOD(DeleteAllStrings)(
/*[in]*/ const CLSID * pCLSID // CLSID of owner (NULL for MMC)
) = 0;
/*[helpstring("Find a string in the snap-in's string table")]*/
STDMETHOD(FindString)(
/*[in]*/ LPCOLESTR pszFind, // string to find in the string table
/*[out]*/ MMC_STRING_ID* pStringID, // ID of string, if found
/*[in]*/ const CLSID * pCLSID // CLSID of owner (NULL for MMC)
) = 0;
/*[helpstring("Returns an enumerator into a snap-in's string table")]*/
STDMETHOD(Enumerate)(
/*[out]*/ IEnumString** ppEnum, // string enumerator
/*[in]*/ const CLSID * pCLSID // CLSID of owner (NULL for MMC)
) = 0;
};
///////////////////////////////////////////////////////////////////////////////
///////////////////////////////////////////////////////////////////////////////
///////////////////////////////////////////////////////////////////////////////
///////////////////////////////////////////////////////////////////////////////
////
//// MMC 1.2 changes
////
// ITaskCallback
// helpstring("Task callback. Handles the drawing and selection notifications of tasks"),
MMC_INTERFACE(ITaskCallback, 4b2293ba-e7ba-11d2-883c-00c04f72c717) : IUnknown
{
/*[helpstring("Determines whether to display "Edit" and "Delete" items for this taskpad.")]*/
STDMETHOD(IsEditable)() = 0;
/*[helpstring("Modifies the underlying taskpad.")]*/
STDMETHOD(OnModifyTaskpad)() = 0;
/*[helpstring("Deletes the underlying taskpad.")]*/
STDMETHOD(OnDeleteTaskpad)() = 0;
/*[helpstring("Gets the GUID identifier of the underlying taskpad.")]*/
STDMETHOD(GetTaskpadID)(/*[out]*/ GUID *pGuid) = 0;
};
// helpstring("Interface for releasing Node Manager's cached com objects"),
MMC_INTERFACE(IComCacheCleanup, 35FEB982-55E9-483b-BD15-149F3F9E6C63) : IUnknown
{
/* gives a chance to release cached OLE objects prior to calling OleUninitialize */
STDMETHOD(ReleaseCachedOleObjects)() = 0;
};
#endif // __ndmgrpriv_h__