📄 hxmon.h
字号:
/************************************************************************
* Method:
* IHXRegistry::SetBufById
* Purpose:
* Modify a Property's BUFFER in the registry given its id "ulId".
* If the value was set, it will return HXR_OK, otherwise it returns
* HXR_FAIL.
*
* ulId - IN - unique id of the Property whose value is to be set
* pValue - IN - the new value of the Property which is going to be set
*/
STDMETHOD(SetBufById) (THIS_
const UINT32 ulId,
IHXBuffer* pValue) PURE;
/************************************************************************
* Method:
* IHXRegistry::AddIntRef
* Purpose:
* Add an INTEGER REFERENCE property with name in "pName" and
* value in "iValue" to the registry. This property allows the user
* to modify its contents directly, without having to go through the
* registry.
*
* pName - IN - name of the Property that is going to be added to
* the registry
* pValue - IN - the pointer of the integer value is what gets stored
* in the registry as the Interger Reference Property's
* value
*/
STDMETHOD_(UINT32, AddIntRef) (THIS_
const char* pName,
INT32* pValue) PURE;
/************************************************************************
* Method:
* IHXRegistry::DeleteByName
* Purpose:
* Delete a Property from the registry using its name "pName".
*
* pName - IN - name of the Property that is going to be deleted
*/
STDMETHOD_(UINT32, DeleteByName) (THIS_
const char* pName) PURE;
/************************************************************************
* Method:
* IHXRegistry::DeleteById
* Purpose:
* Delete a Property from the registry using its id "ulId".
*
* ulId - IN - unique id of the Property that is going to be deleted
*/
STDMETHOD_(UINT32, DeleteById) (THIS_
const UINT32 ulId) PURE;
/************************************************************************
* Method:
* IHXRegistry::GetTypeByName
* Purpose:
* Returns the datatype of the Property given its name "pName".
*
* pName - IN - name of the Property whose type is to be retreived
*/
STDMETHOD_(HXPropType, GetTypeByName) (THIS_
const char* pName) const PURE;
/************************************************************************
* Method:
* IHXRegistry::GetTypeById
* Purpose:
* Returns the datatype of the Property given its its id "ulId".
*
* ulId - IN - unique id of the Property whose type is to be retreived
*/
STDMETHOD_(HXPropType, GetTypeById) (THIS_
const UINT32 ulId) const PURE;
/************************************************************************
* Method:
* IHXRegistry::FindParentIdByName
* Purpose:
* Returns the id value of the parent node of the Property whose
* name "pName" has been passed in. If it fails, a ZERO value is
* returned.
*
* pName - IN - name of the Property whose parent's unique id is to be
* retreived
*/
STDMETHOD_(UINT32, FindParentIdByName) (THIS_
const char* pName) const PURE;
/************************************************************************
* Method:
* IHXRegistry::FindParentIdById
* Purpose:
* Returns the id value of the parent node of the Property whose
* id "ulId" has been passed in. If it fails, a ZERO value is returned.
*
* ulId - IN - unique id of the Property whose parent's id is to be
* retreived
*/
STDMETHOD_(UINT32, FindParentIdById) (THIS_
const UINT32 ulId) const PURE;
/************************************************************************
* Method:
* HXRegistry::GetPropName
* Purpose:
* Returns the Property name in the pName char buffer passed
* as a parameter, given the Property's id "ulId".
*
* ulId - IN - unique id of the Property whose name is to be retreived
* pName - OUT - parameter into which the Property name is going to be
* returned
*/
STDMETHOD(GetPropName) (THIS_
const UINT32 ulId,
REF(IHXBuffer*) pName) const PURE;
/************************************************************************
* Method:
* HXRegistry::GetId
* Purpose:
* Returns the Property's id given the Property name.
*
* pName - IN - name of the Property whose unique id is to be
* retreived
*/
STDMETHOD_(UINT32, GetId) (THIS_
const char* pName) const PURE;
/************************************************************************
* Method:
* IHXRegistry::GetPropListOfRoot
* Purpose:
* Returns an array of a Properties under the root level of the
* registry's hierarchy.
*
* pValues - OUT - list of property name and unique id at the
* highest level (root) in the registry
*/
STDMETHOD(GetPropListOfRoot) (THIS_
REF(IHXValues*) pValues) const PURE;
/************************************************************************
* Method:
* IHXRegistry::GetPropListByName
* Purpose:
* Returns an array of Properties immediately under the one whose
* name is passed in "pName".
*
* pName - IN - name of the Property whose child property list is to be
* retreived
* pValues - OUT - list of property name and unique id under the
* Property whose name is in "pName"
*/
STDMETHOD(GetPropListByName) (THIS_
const char* pName,
REF(IHXValues*) pValues) const PURE;
/************************************************************************
* Method:
* IHXRegistry::GetPropListById
* Purpose:
* Returns an array of Properties immediately under the one whose
* id is passed in "ulId".
*
* ulId - IN - unique id of the Property whose child property list is
* to be retreived
* pValues - OUT - list of property name and unique id under the
* Property whose is is in "ulId"
*/
STDMETHOD(GetPropListById) (THIS_
const UINT32 ulId,
REF(IHXValues*) pValues) const PURE;
/************************************************************************
* Method:
* IHXRegistry::GetNumPropsAtRoot
* Purpose:
* Returns the number of Properties at the root of the registry.
*/
STDMETHOD_(INT32, GetNumPropsAtRoot) (THIS) const PURE;
/************************************************************************
* Method:
* IHXRegistry::GetNumPropsByName
* Purpose:
* Returns the count of the number of Properties under the one
* whose name is specified in "pName".
*
* pName - IN - name of the Property whose number of children is to be
* retreived
*/
STDMETHOD_(INT32, GetNumPropsByName) (THIS_
const char* pName) const PURE;
/************************************************************************
* Method:
* IHXRegistry::GetNumPropsById
* Purpose:
* Returns the count of the number of Properties under the one
* whose unique id is specified in "ulId".
*
* ulId - IN - unique id of the Property whose number of children is
* to be retreived
*/
STDMETHOD_(INT32, GetNumPropsById) (THIS_
const UINT32 ulId) const PURE;
};
/*
*
* Interface:
*
* IHXPropWatch
*
* Purpose:
*
* This interface allows the user to watch properties so that when
* changes happen to the properties the plugins receive notification via
* the IHXPropWatchResponse API.
*
* IID_IHXPropWatch:
*
* {00000601-0901-11d1-8B06-00A024406D59}
*
*/
DEFINE_GUID(IID_IHXPropWatch, 0x00000601, 0x901, 0x11d1, 0x8b, 0x6, 0x0,
0xa0, 0x24, 0x40, 0x6d, 0x59);
#undef INTERFACE
#define INTERFACE IHXPropWatch
DECLARE_INTERFACE_(IHXPropWatch, IUnknown)
{
/*
* IUnknown methods
*/
STDMETHOD(QueryInterface) (THIS_
REFIID riid,
void** ppvObj) PURE;
STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
STDMETHOD_(ULONG32,Release) (THIS) PURE;
/*
* IHXPropWatch methods
*/
/************************************************************************
* Method:
* IHXPropWatch::Init
* Purpose:
* Initialize with the response object so that the Watch
* notifications can be sent back to the respective plugins.
*
* pResponse - IN - pointer to the response object which gets used to
* initialize the IHXPropWatch object. the response
* object gets AddRef'd in the Init method.
*/
STDMETHOD(Init) (THIS_
IHXPropWatchResponse* pResponse) PURE;
/************************************************************************
* Method:
* IHXPropWatch::SetWatchOnRoot
* Purpose:
* The SetWatch method puts a watch at the highest level of
* the registry hierarchy. It notifies ONLY IF properties at THIS LEVEL
* get added/modified/deleted.
*/
STDMETHOD_(UINT32, SetWatchOnRoot) (THIS) PURE;
/************************************************************************
* Method:
* IHXPropWatch::SetWatchByName
* Purpose:
* Sets a watch-point on the Property whose name is passed in.
* In case the mentioned Property gets modified or deleted a
* notification of that will be sent to the object which set the
* watch-point.
*
* pName - IN - name of Property on which a watch point is to be added
*/
STDMETHOD_(UINT32, SetWatchByName) (THIS_
const char* pName) PURE;
/************************************************************************
* Method:
* IHXPropWatch::SetWatchById
* Purpose:
* Sets a watch-point on the Property whose name is passed in.
* In case the mentioned Property gets modified or deleted a
* notification of that will be sent to the object which set the
* watch-point.
*
* ulId - IN - unique id of Property on which a watch point is to be
* added
*/
STDMETHOD_(UINT32, SetWatchById) (THIS_
const UINT32 ulId) PURE;
/************************************************************************
* Method:
* IHXPropWatch::ClearWatchOnRoot
* Purpose:
* It clears the watch on the root of the registry.
*/
STDMETHOD(ClearWatchOnRoot) (THIS) PURE;
/************************************************************************
* Method:
* IHXPropWatch::ClearWatchByName
* Purpose:
* Clears a watch-point based on the Property's name.
*
* pName - IN - name of Property whose watch point is to be cleared
*/
STDMETHOD(ClearWatchByName) (THIS_
const char* pName) PURE;
/************************************************************************
* Method:
* IHXPropWatch::ClearWatchById
* Purpose:
* Clears a watch-point based on the Property's id.
*
* ulId - IN - unique id of Property whose watch point is to be cleared
*/
STDMETHOD(ClearWatchById) (THIS_
const UINT32 ulId) PURE;
};
/*
*
* Interface:
*
* IHXPropWatchResponse
*
* Purpose:
*
* Interface for notification of additions/modifications/deletions of
* properties in the registry which are being watched.
*
* IID_IHXPropWatchResponse:
*
* {00000602-0901-11d1-8B06-00A024406D59}
*
*/
DEFINE_GUID(IID_IHXPropWatchResponse, 0x00000602, 0x901, 0x11d1, 0x8b, 0x6, 0x0,
0xa0, 0x24, 0x40, 0x6d, 0x59);
#undef INTERFACE
#define INTERFACE IHXPropWatchResponse
DECLARE_INTERFACE_(IHXPropWatchResponse, IUnknown)
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -