* *      1) Provide atomic update methods *      2) Provide INT64 support *      3) Provide access to INTREF pointers * *      All operations occur atomically, ensuring that multiple users of the *      registry do not interfere with each other, even on multi-CPU systems. *      Note, this is essentially a superset of IHXRegistry. * *  IID_IHXRegistry2 * *	{00000608-0901-11d1-8B06-00A024406D59} * */DEFINE_GUID(IID_IHXRegistry2, 0x00000608, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 			0xa0, 0x24, 0x40, 0x6d, 0x59);#undef  INTERFACE#define INTERFACE IHXRegistry2DECLARE_INTERFACE_(IHXRegistry2, IUnknown){    /*     *	IUnknown methods     */    STDMETHOD(QueryInterface)	(THIS_				REFIID riid,				void** ppvObj) PURE;    STDMETHOD_(ULONG32,AddRef)	(THIS) PURE;    STDMETHOD_(ULONG32,Release)	(THIS) PURE;    /*     *	IHXRegistry2 methods     */    /************************************************************************     *  Method:     *      IHXRegistry2::CreatePropWatch     *  Purpose:     *      Create a new IHXPropWatch object which can then be queried for      *  the right kind of IHXPropWatch object.     *     *  pPropWatch - OUT - returns a new addref'ed IHXPropWatch object      */    STDMETHOD(CreatePropWatch)		(THIS_					REF(IHXPropWatch*) pPropWatch) PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::AddComp     *  Purpose:     *      Add a COMPOSITE property to the registry and return its ID     *  if successful. It returns ZERO (0) if an error occurred     *  during the operation.     *     *  pName - IN - name of the Property that is going to be added to      *               the registry     */    STDMETHOD_(UINT32, AddComp)		(THIS_					const char*	pName) PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::AddInt     *  Purpose:     *      Add an INTEGER property with name in "pName" and value in      *  "iValue" to the registry. The return value is the id to     *  the newly added Property or ZERO if there was an error.     *     *  pName - IN - name of the Property that is going to be added to      *               the registry     *  nValue - IN - integer value of the Property that is going to be      *                added to the registry     */    STDMETHOD_(UINT32, AddInt)		(THIS_					const char*	pName, 					const INT32	nValue) PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::GetIntByName     *  Purpose:     *      Retreive an INTEGER value from the registry given its Property     *  name "pName". If the Property is found, it will return HXR_OK,      *  otherwise it returns HXR_FAIL.     *     *  pName - IN - name of the Property whose value is to be retrieved     *  nValue - OUT - parameter into which the value of the Property is      *                 going to be returned     */    STDMETHOD(GetIntByName)		(THIS_					const char*	pName,					REF(INT32)	nValue) const PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::GetIntById     *  Purpose:     *      Retreive an INTEGER value from the registry given its id "ulId".      *  If the Property is found, it will return HXR_OK, otherwise it      *  returns HXR_FAIL.     *     *  ulId - IN - unique id of the Property whose value is to be retrieved     *  nValue - OUT - parameter into which the value of the Property is      *                 going to be returned     */    STDMETHOD(GetIntById)		(THIS_					const UINT32	ulId,					REF(INT32)	nValue) const PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::SetIntByName     *  Purpose:     *      Modify a Property's INTEGER value in the registry given the     *  Property's name "pName". If the value was set, it will return HXR_OK,      *  otherwise it returns HXR_FAIL.     *     *  pName - IN - name of the Property whose value is to be set     *  nValue - IN - the new value of the Property which is going to be set     */    STDMETHOD(SetIntByName)		(THIS_					const char*	pName, 					const INT32	nValue) PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::SetIntById     *  Purpose:     *      Modify a Property's INTEGER value in the registry given the     *  its id "id". 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     *  nValue - IN - the new value of the Property which is going to be set     */    STDMETHOD(SetIntById)		(THIS_					const UINT32	id,					const INT32	nValue) PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::AddStr     *  Purpose:     *      Add an STRING property with name in "pName" and value in      *  "pValue" to the registry and return its ID if successful.     *  It returns ZERO (0) if an error occurred during the operation.     *     *  pName - IN - name of the Property that is going to be added to      *               the registry     *  pValue - IN - buffer value of the Property that is going to be      *                added to the registry     */    STDMETHOD_(UINT32, AddStr)		(THIS_					const char*	pName, 					IHXBuffer*	pValue) PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::GetStrByName     *  Purpose:     *      Retreive an STRING value from the registry given its Property     *  name "pName". If the Property is found, it will return HXR_OK,      *  otherwise it returns HXR_FAIL.     *     *  pName - IN - name of the Property whose value is to be retrieved     *  pValue - OUT - parameter into which the value of the Property is      *                 going to be returned     */    STDMETHOD(GetStrByName)		(THIS_					const char*	 pName,					REF(IHXBuffer*) pValue) const PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::GetStrById     *  Purpose:     *      Retreive an STRING value from the registry given its id "ulId".      *  If the Property is found, it will return HXR_OK, otherwise it      *  returns HXR_FAIL.     *     *  ulId - IN - unique id of the Property whose value is to be retrieved     *  pValue - OUT - parameter into which the value of the Property is      *                 going to be returned     */    STDMETHOD(GetStrById)		(THIS_					const UINT32	 ulId,					REF(IHXBuffer*) pValue) const PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::SetStrByName     *  Purpose:     *      Modify a Property's STRING value in the registry given the     *  Property's name "pName". If the value was set, it will return      *  HXR_OK, otherwise it returns HXR_FAIL.     *     *  pName - IN - name of the Property whose value is to be set     *  pValue - IN - the new value of the Property which is going to be set     */    STDMETHOD(SetStrByName)		(THIS_					const char*	pName, 					IHXBuffer*	pValue) PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::SetStrById     *  Purpose:     *      Modify a Property's STRING value in the registry given the     *  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(SetStrById)		(THIS_					const UINT32	ulId,					IHXBuffer*	pValue) PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::AddBuf     *  Purpose:     *      Add an BUFFER property with name in "pName" and value in      *  "pValue" to the registry  and return its ID if successful.     *  It returns ZERO (0) if an error occurred during the operation.     *     *  pName - IN - name of the Property that is going to be added to      *               the registry     *  pValue - IN - buffer value of the Property that is going to be      *                added to the registry     */    STDMETHOD_(UINT32, AddBuf)		(THIS_					const char*	pName, 					IHXBuffer*	pValue) PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::GetBufByName     *  Purpose:     *      Retreive the BUFFER from the registry given its Property name      *  "pName". If the Property is found, it will return HXR_OK, otherwise      *  it returns HXR_FAIL.     *     *  pName - IN - name of the Property whose value is to be retrieved     *  pValue - OUT - parameter into which the value of the Property is      *                 going to be returned     */    STDMETHOD(GetBufByName)		(THIS_					const char*	 pName,					REF(IHXBuffer*) pValue) const PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::GetBufById     *  Purpose:     *      Retreive the BUFFER from the registry given its id "ulId". If the      *  Property is found, it will return HXR_OK, otherwise it returns      *  HXR_FAIL.     *     *  ulId - IN - unique id of the Property whose value is to be retrieved     *  pValue - OUT - parameter into which the value of the Property is      *                 going to be returned     */    STDMETHOD(GetBufById)		(THIS_					const UINT32	 ulId,					REF(IHXBuffer*) pValue) const PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::SetBufByName     *  Purpose:     *      Modify a Property's BUFFER in the registry given the     *  Property's name "pName". If the value was set, it will return      *  HXR_OK, otherwise it returns HXR_FAIL.     *     *  pName - IN - name of the Property whose value is to be set     *  pValue - IN - the new value of the Property which is going to be set     */    STDMETHOD(SetBufByName)		(THIS_					const char*	pName, 					IHXBuffer*	pValue) PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::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:     *      IHXRegistry2::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.  The Property's id is returned if successful.     *  It returns ZERO (0) if an error occurred during the operation.     *     *  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:     *      IHXRegistry2::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:     *      IHXRegistry2::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:     *      IHXRegistry2::GetTypeByName     *  Purpose:     *      Returns the datatype of the Property given its name "pName".     *     *  pName - IN - name of the Property whose type is to be retrieved     */    STDMETHOD_(HXPropType, GetTypeByName)	(THIS_						const char* pName) const PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::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 retrieved     */    STDMETHOD_(HXPropType, GetTypeById)	(THIS_						const UINT32 ulId) const PURE;    /************************************************************************     *  Method:     *      IHXRegistry2::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.