180 lines
5.3 KiB
C
180 lines
5.3 KiB
C
|
//+-------------------------------------------------------------------------
|
|||
|
|
//
|
|||
|
|
// Microsoft Windows
|
|||
|
|
// Copyright (C) Microsoft Corporation, 1992 - 1993.
|
|||
|
|
//
|
|||
|
|
// File: daholder.h
|
|||
|
|
//
|
|||
|
|
// Contents: CDAHolder, concrete version of IDataAdviseHolder
|
|||
|
|
//
|
|||
|
|
// Classes: CDAHolder
|
|||
|
|
//
|
|||
|
|
// Functions:
|
|||
|
|
//
|
|||
|
|
// History: dd-mmm-yy Author Comment
|
|||
|
|
// 06-Feb-95 t-ScottH created - split class definition from
|
|||
|
|
// cpp file (for debug purposes)
|
|||
|
|
// - added Dump method to CDAHolder
|
|||
|
|
//
|
|||
|
|
//--------------------------------------------------------------------------
|
|||
|
|
|
|||
|
|
#ifndef _DAHOLDER_H_
|
|||
|
|
#define _DAHOLDER_H_
|
|||
|
|
|
|||
|
|
#ifdef _DEBUG
|
|||
|
|
#include <dbgexts.h>
|
|||
|
|
#endif // _DEBUG
|
|||
|
|
|
|||
|
|
//+----------------------------------------------------------------------------
|
|||
|
|
//
|
|||
|
|
// Class:
|
|||
|
|
// CDAHolder
|
|||
|
|
//
|
|||
|
|
// Purpose:
|
|||
|
|
// provides concrete implementation of IDataAdviseHolder
|
|||
|
|
//
|
|||
|
|
// Interface:
|
|||
|
|
// IDataAdviseHolder
|
|||
|
|
//
|
|||
|
|
// Notes:
|
|||
|
|
// REVIEW, not thread safe, under assumption that docs cant be MT
|
|||
|
|
//
|
|||
|
|
// Connections are numbered from [1..infinity). We don't use
|
|||
|
|
// zero to avoid getting caught on someone else's zero init'ed
|
|||
|
|
// memory. Zero is checked for as a connection number on entry
|
|||
|
|
// to routines, and rejected. This allows us to use zero as
|
|||
|
|
// a way to mark unused STATDATA entries in our array.
|
|||
|
|
//
|
|||
|
|
// History:
|
|||
|
|
// 06-Feb-95 t-Scotth added Dump method (_DEBUG only)
|
|||
|
|
// 01/24/94 - AlexGo - now inherit from CPrivAlloc
|
|||
|
|
// 10/29/93 - ChrisWe - file inspection and cleanup
|
|||
|
|
//
|
|||
|
|
//-----------------------------------------------------------------------------
|
|||
|
|
|
|||
|
|
// NOTE: CDAHolder MUST inherit from IDataAdviseHolder first in order for the
|
|||
|
|
// DumpCDAHolder function to work since we cast the IDataAdviseHolder as a
|
|||
|
|
// CDAHolder (if it inherits from IDataAdviseHolder first, then the pointers
|
|||
|
|
// are the same)
|
|||
|
|
|
|||
|
|
class FAR CDAHolder : public IDataAdviseHolder, public CSafeRefCount
|
|||
|
|
{
|
|||
|
|
public:
|
|||
|
|
CDAHolder();
|
|||
|
|
|
|||
|
|
// *** IUnknown methods ***
|
|||
|
|
STDMETHOD(QueryInterface) (REFIID riid, LPVOID FAR* ppv);
|
|||
|
|
STDMETHOD_(ULONG,AddRef) () ;
|
|||
|
|
STDMETHOD_(ULONG,Release) ();
|
|||
|
|
|
|||
|
|
// *** IDataAdviseHolder methods ***
|
|||
|
|
STDMETHOD(Advise)(LPDATAOBJECT pDataObj, FORMATETC FAR* pFetc,
|
|||
|
|
DWORD advf, IAdviseSink FAR* pAdvSink,
|
|||
|
|
DWORD FAR* pdwConnection);
|
|||
|
|
STDMETHOD(Unadvise)(DWORD dwConnection);
|
|||
|
|
STDMETHOD(EnumAdvise)(IEnumSTATDATA FAR* FAR* ppenumAdvise);
|
|||
|
|
|
|||
|
|
STDMETHOD(SendOnDataChange)(IDataObject FAR* pDataObject,
|
|||
|
|
DWORD dwReserved, DWORD advf);
|
|||
|
|
|
|||
|
|
// *** debug and dump methods ***
|
|||
|
|
#ifdef _DEBUG
|
|||
|
|
|
|||
|
|
HRESULT Dump(char **ppszDump, ULONG ulFlag, int nIndentLevel);
|
|||
|
|
|
|||
|
|
// need to be able to access CDAHolder private data members in the
|
|||
|
|
// following debugger extension APIs
|
|||
|
|
// this allows the debugger extension APIs to copy memory from the
|
|||
|
|
// debuggee process memory to the debugger's process memory
|
|||
|
|
// this is required since the Dump method follows pointers to other
|
|||
|
|
// structures and classes
|
|||
|
|
friend DEBUG_EXTENSION_API(dump_daholder);
|
|||
|
|
friend DEBUG_EXTENSION_API(dump_enumstatdata);
|
|||
|
|
friend DEBUG_EXTENSION_API(dump_dataadvisecache);
|
|||
|
|
friend DEBUG_EXTENSION_API(dump_defobject);
|
|||
|
|
friend DEBUG_EXTENSION_API(dump_deflink);
|
|||
|
|
|
|||
|
|
#endif // _DEBUG
|
|||
|
|
|
|||
|
|
private:
|
|||
|
|
~CDAHolder();
|
|||
|
|
|
|||
|
|
|
|||
|
|
DWORD m_dwConnection; // next connection number to use
|
|||
|
|
int m_iSize; // number of stat data elements in array
|
|||
|
|
STATDATA FAR *m_pSD; // array of STATDATA elements
|
|||
|
|
#define CDAHOLDER_GROWBY 5 /* number of entries to grow array by each time */
|
|||
|
|
|
|||
|
|
SET_A5;
|
|||
|
|
|
|||
|
|
// the enumerator returned by the EnumAdvise method
|
|||
|
|
friend class CEnumSTATDATA;
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
//+----------------------------------------------------------------------------
|
|||
|
|
//
|
|||
|
|
// Class:
|
|||
|
|
// CEnumSTATDATA
|
|||
|
|
//
|
|||
|
|
// Purpose:
|
|||
|
|
// is the enumerator returned by CDAHolder::Enum
|
|||
|
|
//
|
|||
|
|
// Interface:
|
|||
|
|
// IEnumSTATDATA
|
|||
|
|
//
|
|||
|
|
// Notes:
|
|||
|
|
// Keeps the underlying CDAHolder alive for the lifetime of
|
|||
|
|
// the enumerator.
|
|||
|
|
//
|
|||
|
|
// History:
|
|||
|
|
// 10/29/93 - ChrisWe - file inspection and cleanup
|
|||
|
|
//
|
|||
|
|
//-----------------------------------------------------------------------------
|
|||
|
|
|
|||
|
|
class CEnumSTATDATA : public IEnumSTATDATA, public CPrivAlloc
|
|||
|
|
{
|
|||
|
|
public:
|
|||
|
|
CEnumSTATDATA(CDAHolder FAR* pHolder, int iDataStart);
|
|||
|
|
|
|||
|
|
// *** IUnknown methods ***
|
|||
|
|
STDMETHOD(QueryInterface)(REFIID riid, LPVOID FAR* ppv);
|
|||
|
|
STDMETHOD_(ULONG,AddRef)() ;
|
|||
|
|
STDMETHOD_(ULONG,Release)();
|
|||
|
|
|
|||
|
|
// *** IEnumSTATDATA methods ***
|
|||
|
|
STDMETHOD(Next)(ULONG celt, STATDATA FAR * rgelt,
|
|||
|
|
ULONG FAR* pceltFetched);
|
|||
|
|
STDMETHOD(Skip)(ULONG celt);
|
|||
|
|
STDMETHOD(Reset)();
|
|||
|
|
STDMETHOD(Clone)(LPENUMSTATDATA FAR* ppenum);
|
|||
|
|
|
|||
|
|
#ifdef _DEBUG
|
|||
|
|
|
|||
|
|
HRESULT Dump(char **ppszDump, ULONG ulFlag, int nIndentLevel);
|
|||
|
|
|
|||
|
|
|
|||
|
|
// need to be able to access CEnumSTATDATA private data members in the
|
|||
|
|
// following debugger extension APIs
|
|||
|
|
// this allows the debugger extension APIs to copy memory from the
|
|||
|
|
// debuggee process memory to the debugger's process memory
|
|||
|
|
// this is required since the Dump method follows pointers to other
|
|||
|
|
// structures and classes
|
|||
|
|
friend DEBUG_EXTENSION_API(dump_enumstatdata);
|
|||
|
|
|
|||
|
|
#endif // _DEBUG
|
|||
|
|
|
|||
|
|
private:
|
|||
|
|
~CEnumSTATDATA();
|
|||
|
|
|
|||
|
|
ULONG m_refs; // reference count
|
|||
|
|
int m_iDataEnum; // index of the next element to return
|
|||
|
|
|
|||
|
|
CDAHolder FAR* m_pHolder; // pointer to holder; is ref counted
|
|||
|
|
|
|||
|
|
SET_A5;
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
#endif // _DAHOLDER_H_
|
|||
|
|
|