home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / com / tutsamp / dcomdraw / sink.cpp < prev    next >
C/C++ Source or Header  |  1997-08-30  |  19KB  |  573 lines
  1. /*+==========================================================================
  2.   File:      SINK.CPP
  3.  
  4.   Summary:   Implementation file for the COPaperSink COM Object Class.
  5.              Connectable object notifications are handled by COPaperSink.
  6.  
  7.              COPaperSink offers a main IUnknown interface and the custom
  8.              IPaperSink interface (with the drawing Paper related event
  9.              features). This multiple interface COM Object Class is
  10.              achieved via the technique of nested classes.  The
  11.              implementation of the IPaperSink interface is nested inside
  12.              the COPaperSink Class.
  13.  
  14.              For a comprehensive tutorial code tour of this module's
  15.              contents and offerings see the tutorial DCOMDRAW.HTM
  16.              file. For more specific technical details on the internal
  17.              workings see the comments dispersed throughout the module's
  18.              source code.
  19.  
  20.   Classes:   COPaperSink.
  21.  
  22.   Functions: none.
  23.  
  24.   Origin:    8-23-97: atrent - Editor-inheritance from BALL.CPP in
  25.              the CONSERVE Tutorial Code Sample. [Revised]
  26.  
  27. ----------------------------------------------------------------------------
  28.   This file is part of the Microsoft COM Tutorial Code Samples.
  29.  
  30.   Copyright (C) Microsoft Corporation, 1997.  All rights reserved.
  31.  
  32.   This source code is intended only as a supplement to Microsoft
  33.   Development Tools and/or on-line documentation.  See these other
  34.   materials for detailed information regarding Microsoft code samples.
  35.  
  36.   THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  37.   KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  38.   IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
  39.   PARTICULAR PURPOSE.
  40. ==========================================================================+*/
  41.  
  42.  
  43. /*---------------------------------------------------------------------------
  44.   We include WINDOWS.H for all Win32 applications.
  45.   We include OLE2.H because we will be calling the COM/OLE Libraries.
  46.   We include OLECTL.H because it has definitions for connectable objects.
  47.   We include APPUTIL.H because we will be building this application using
  48.     the convenient Virtual Window and Dialog classes and other
  49.     utility functions in the APPUTIL Library (ie, APPUTIL.LIB).
  50.   We include PAPINT.H and PAPGUIDS.H for the common paper-related
  51.     Interface class, GUID, and CLSID specifications.
  52.   We include GUIPAPER.H because it declares the class for the main C++
  53.     object that can service the Sink events.
  54.   We include SINK.H because it has the class COPaperSink declarations.
  55. ---------------------------------------------------------------------------*/
  56. #include <windows.h>
  57. #include <ole2.h>
  58. #include <olectl.h>
  59. #include <apputil.h>
  60. #include <papint.h>
  61. #include <papguids.h>
  62. #include "guipaper.h"
  63. #include "sink.h"
  64.  
  65.  
  66. /*---------------------------------------------------------------------------
  67.   COPaperSink's implementation of its main COM object class including
  68.   Constructor, Destructor, QueryInterface, AddRef, and Release.
  69. ---------------------------------------------------------------------------*/
  70.  
  71. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  72.   Method:   COPaperSink::COPaperSink
  73.  
  74.   Summary:  COPaperSink Constructor. Note the member initializer:
  75.             "m_ImpIPaperSink(this, pUnkOuter)" which is used to pass the
  76.             'this' and pUnkOuter pointers of this constructor function to
  77.             the constructor in the instantiation of the implementation of
  78.             the CImpIPaperSink interface (which is nested inside this
  79.             present COPaperSink Object Class).
  80.  
  81.   Args:     IUnknown* pUnkOuter,
  82.               Pointer to the the outer Unknown.  NULL means this COM Object
  83.               is not being Aggregated.  Non NULL means it is being created
  84.               on behalf of an outside COM object that is reusing it via
  85.               aggregation.
  86.             CGuiPaper* pGuiPaper)
  87.               Pointer to the main C++ object that can service the PaperSink
  88.               events.
  89.  
  90.   Modifies: m_cRefs, m_pUnkOuter, m_pGuiPaper.
  91.  
  92.   Returns:  void
  93. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  94. COPaperSink::COPaperSink(
  95.   IUnknown* pUnkOuter,
  96.   CGuiPaper* pGuiPaper) :
  97.   m_ImpIPaperSink(this, pUnkOuter)
  98. {
  99.   // Zero the COM object's reference count.
  100.   m_cRefs = 0;
  101.  
  102.   // No AddRef necessary if non-NULL, as we're nested.
  103.   m_pUnkOuter = pUnkOuter;
  104.  
  105.   // Assign the pointer to the Sink service C++ object.
  106.   m_pGuiPaper = pGuiPaper;
  107.  
  108.   return;
  109. }
  110.  
  111.  
  112. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  113.   Method:   COPaperSink::~COPaperSink
  114.  
  115.   Summary:  COPaperSink Destructor.
  116.  
  117.   Args:     void
  118.  
  119.   Returns:  void
  120. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  121. COPaperSink::~COPaperSink(void)
  122. {
  123.   return;
  124. }
  125.  
  126.  
  127. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  128.   Method:   COPaperSink::QueryInterface
  129.  
  130.   Summary:  QueryInterface of the COPaperSink non-delegating
  131.             IUnknown implementation.
  132.  
  133.   Args:     REFIID riid,
  134.               [in] GUID of the Interface being requested.
  135.             PPVOID ppv)
  136.               [out] Address of the caller's pointer variable that will
  137.               receive the requested interface pointer.
  138.  
  139.   Returns:  HRESULT
  140. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  141. STDMETHODIMP COPaperSink::QueryInterface(
  142.                REFIID riid,
  143.                PPVOID ppv)
  144. {
  145.   HRESULT hr = E_NOINTERFACE;
  146.  
  147.   *ppv = NULL;
  148.  
  149.   if (IID_IUnknown == riid)
  150.     *ppv = this;
  151.   else if (IID_IPaperSink == riid)
  152.     *ppv = &m_ImpIPaperSink;
  153.  
  154.   if (NULL != *ppv)
  155.   {
  156.     // We've handed out a pointer to the interface so obey the COM rules
  157.     // and AddRef the reference count.
  158.     ((LPUNKNOWN)*ppv)->AddRef();
  159.     hr = NOERROR;
  160.   }
  161.  
  162.  
  163.   return (hr);
  164. }
  165.  
  166.  
  167. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  168.   Method:   COPaperSink::AddRef
  169.  
  170.   Summary:  AddRef of the COPaperSink non-delegating IUnknown
  171.             implementation.
  172.  
  173.   Args:     void
  174.  
  175.   Modifies: m_cRefs.
  176.  
  177.   Returns:  ULONG
  178.               New value of m_cRefs (COM object's reference count).
  179. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  180. STDMETHODIMP_(ULONG) COPaperSink::AddRef(void)
  181. {
  182.   ULONG cRefs;
  183.  
  184.   cRefs = ++m_cRefs;
  185.  
  186.   return cRefs;
  187. }
  188.  
  189.  
  190. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  191.   Method:   COPaperSink::Release
  192.  
  193.   Summary:  Release of the COPaperSink non-delegating IUnknown
  194.             implementation.
  195.  
  196.   Args:     void
  197.  
  198.   Modifies: m_cRefs.
  199.  
  200.   Returns:  ULONG
  201.               New value of m_cRefs (COM object's reference count).
  202. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  203. STDMETHODIMP_(ULONG) COPaperSink::Release(void)
  204. {
  205.   ULONG cRefs;
  206.  
  207.   cRefs = --m_cRefs;
  208.  
  209.   if (0 == cRefs)
  210.   {
  211.     // We artificially bump the main ref count to prevent reentrancy
  212.     // via the main object destructor.  Not really needed in this
  213.     // COPaperSink but a good practice because we are aggregatable and
  214.     // may at some point in the future add something entertaining like
  215.     // some Releases to the COPaperSink destructor.
  216.     m_cRefs++;
  217.     delete this;
  218.   }
  219.  
  220.   return cRefs;
  221. }
  222.  
  223.  
  224. /*---------------------------------------------------------------------------
  225.   COPaperSink's nested implementation of the IPaperSink interface
  226.   including Constructor, Destructor, QueryInterface, AddRef, Release,
  227.   Locked, Unlocked, Loaded, Saved, InkStart, InkDraw, InkStop, Erased,
  228.   and Resized. Methods in this interface are called by COM objects on
  229.   the server side to send notifications to the client.
  230. ---------------------------------------------------------------------------*/
  231.  
  232. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  233.   Method:   COPaperSink::CImpIPaperSink::CImpIPaperSink
  234.  
  235.   Summary:  Constructor for the CImpIPaperSink interface instantiation.
  236.  
  237.   Args:     COPaperSink* pCO,
  238.               Back pointer to the parent outer object.
  239.             IUnknown* pUnkOuter
  240.               Pointer to the outer Unknown.  For delegation.
  241.  
  242.   Modifies: m_pCO, m_pUnkOuter.
  243.  
  244.   Returns:  void
  245. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  246. COPaperSink::CImpIPaperSink::CImpIPaperSink(
  247.   COPaperSink* pCO,
  248.   IUnknown* pUnkOuter)
  249. {
  250.   // Init the Back Object Pointer to point to the parent object.
  251.   m_pCO = pCO;
  252.  
  253.   // Init the CImpIPaperSink interface's delegating Unknown pointer.  We
  254.   // use the Back Object pointer for IUnknown delegation here if we are
  255.   // not being aggregated.  If we are being aggregated we use the supplied
  256.   // pUnkOuter for IUnknown delegation.  In either case the pointer
  257.   // assignment requires no AddRef because the CImpIPaperSink lifetime is
  258.   // quaranteed by the lifetime of the parent object in which
  259.   // CImpIPaperSink is nested.
  260.   if (NULL == pUnkOuter)
  261.     m_pUnkOuter = pCO;
  262.   else
  263.     m_pUnkOuter = pUnkOuter;
  264.  
  265.   return;
  266. }
  267.  
  268.  
  269. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  270.   Method:   COPaperSink::CImpIPaperSink::~CImpIPaperSink
  271.  
  272.   Summary:  Destructor for the CImpIPaperSink interface instantiation.
  273.  
  274.   Args:     void
  275.  
  276.   Returns:  void
  277. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  278. COPaperSink::CImpIPaperSink::~CImpIPaperSink(void)
  279. {
  280.   return;
  281. }
  282.  
  283.  
  284. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  285.   Method:   COPaperSink::CImpIPaperSink::QueryInterface
  286.  
  287.   Summary:  The QueryInterface IUnknown member of this IPaperSink interface
  288.             implementation that delegates to m_pUnkOuter, whatever it is.
  289.  
  290.   Args:     REFIID riid,
  291.               [in] GUID of the Interface being requested.
  292.             PPVOID ppv)
  293.               [out] Address of the caller's pointer variable that will
  294.               receive the requested interface pointer.
  295.  
  296.   Returns:  HRESULT
  297.               Returned by the delegated outer QueryInterface call.
  298. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  299. STDMETHODIMP COPaperSink::CImpIPaperSink::QueryInterface(
  300.                REFIID riid,
  301.                PPVOID ppv)
  302. {
  303.   // Delegate this call to the outer object's QueryInterface.
  304.   return m_pUnkOuter->QueryInterface(riid, ppv);
  305. }
  306.  
  307.  
  308. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  309.   Method:   COPaperSink::CImpIPaperSink::AddRef
  310.  
  311.   Summary:  The AddRef IUnknown member of this IPaperSink interface
  312.             implementation that delegates to m_pUnkOuter, whatever it is.
  313.  
  314.   Args:     void
  315.  
  316.   Returns:  ULONG
  317.               Returned by the delegated outer AddRef call.
  318. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  319. STDMETHODIMP_(ULONG) COPaperSink::CImpIPaperSink::AddRef(void)
  320. {
  321.   // Delegate this call to the outer object's AddRef.
  322.   return m_pUnkOuter->AddRef();
  323. }
  324.  
  325.  
  326. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  327.   Method:   COPaperSink::CImpIPaperSink::Release
  328.  
  329.   Summary:  The Release IUnknown member of this IPaperSink interface
  330.             implementation that delegates to m_pUnkOuter, whatever it is.
  331.  
  332.   Args:     void
  333.  
  334.   Returns:  ULONG
  335.               Returned by the delegated outer Release call.
  336. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  337. STDMETHODIMP_(ULONG) COPaperSink::CImpIPaperSink::Release(void)
  338. {
  339.   // Delegate this call to the outer object's Release.
  340.   return m_pUnkOuter->Release();
  341. }
  342.  
  343.  
  344. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  345.   Method:   COPaperSink::CImpIPaperSink::Locked
  346.  
  347.   Summary:  The COPaper object was locked by a client.
  348.  
  349.   Args:     void
  350.  
  351.   Returns:  HRESULT
  352.               Standard result code. NOERROR for success.
  353. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  354. STDMETHODIMP COPaperSink::CImpIPaperSink::Locked(
  355.                void)
  356. {
  357.   HRESULT hr = E_NOTIMPL;
  358.  
  359.   // For future evolution.
  360.  
  361.   return hr;
  362. }
  363.  
  364.  
  365. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  366.   Method:   COPaperSink::CImpIPaperSink::Unlocked
  367.  
  368.   Summary:  The COPaper object was Unlocked by a client.
  369.  
  370.   Args:     void
  371.  
  372.   Returns:  HRESULT
  373.               Standard result code. NOERROR for success.
  374. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  375. STDMETHODIMP COPaperSink::CImpIPaperSink::Unlocked(
  376.                void)
  377. {
  378.   HRESULT hr = E_NOTIMPL;
  379.  
  380.   // For future evolution.
  381.  
  382.   return hr;
  383. }
  384.  
  385.  
  386. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  387.   Method:   COPaperSink::CImpIPaperSink::Loaded
  388.  
  389.   Summary:  The COPaper object's ink drawing data was loaded from a
  390.             client's compound file.
  391.  
  392.   Args:     void
  393.  
  394.   Returns:  HRESULT
  395.               Standard result code. NOERROR for success.
  396. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  397. STDMETHODIMP COPaperSink::CImpIPaperSink::Loaded(
  398.                void)
  399. {
  400.   HRESULT hr;
  401.  
  402.   // We have been notified that a load was done. Thus, a whole new array
  403.   // of ink data must be displayed in a cleared window of this client.
  404.   m_pCO->m_pGuiPaper->ClearWin();
  405.   hr = m_pCO->m_pGuiPaper->PaintWin();
  406.  
  407.   return hr;
  408. }
  409.  
  410.  
  411. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  412.   Method:   COPaperSink::CImpIPaperSink::Saved
  413.  
  414.   Summary:  The COPaper object's drawing paper data was saved to a
  415.             client's compound file.
  416.  
  417.   Args:     void
  418.  
  419.   Returns:  HRESULT
  420.               Standard result code. NOERROR for success.
  421. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  422. STDMETHODIMP COPaperSink::CImpIPaperSink::Saved(
  423.                void)
  424. {
  425.   HRESULT hr = E_NOTIMPL;
  426.  
  427.   // For future evolution.
  428.  
  429.   return hr;
  430. }
  431.  
  432.  
  433. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  434.   Method:   COPaperSink::CImpIPaperSink::InkStart
  435.  
  436.   Summary:  Client is being told to start a display ink drawing sequence.
  437.  
  438.   Args:     SHORT nX,
  439.               X coordinate of the start point.
  440.             SHORT nY,
  441.               Y coordinate of the start point.
  442.             SHORT nWidth,
  443.               Ink Width in pixels.
  444.             COLORREF crInkColor)
  445.               RGB Ink color to be used in the subsequent inking sequence.
  446.  
  447.   Returns:  HRESULT
  448.               Standard result code. NOERROR for success.
  449. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  450. STDMETHODIMP COPaperSink::CImpIPaperSink::InkStart(
  451.                                             SHORT nX,
  452.                                             SHORT nY,
  453.                                             SHORT nWidth,
  454.                                             COLORREF crInkColor)
  455. {
  456.   // Only echo drawing action if we are not the current Master.
  457.   if (!m_pCO->m_pGuiPaper->Master())
  458.   {
  459.     // Play the data back to the CGuiPaper for display only.
  460.     m_pCO->m_pGuiPaper->InkWidth(nWidth);
  461.     m_pCO->m_pGuiPaper->InkColor(crInkColor);
  462.     m_pCO->m_pGuiPaper->InkStart(nX, nY);
  463.   }
  464.  
  465.   return NOERROR;
  466. }
  467.  
  468.  
  469. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  470.   Method:   COPaperSink::CImpIPaperSink::InkDraw
  471.  
  472.   Summary:  Client is being told to draw/display ink drawing sequence data.
  473.  
  474.   Args:     SHORT nX,
  475.               X coordinate of the start point.
  476.             SHORT nY,
  477.               Y coordinate of the start point.
  478.  
  479.   Returns:  HRESULT
  480.               Standard result code. NOERROR for success.
  481. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  482. STDMETHODIMP COPaperSink::CImpIPaperSink::InkDraw(
  483.                                             SHORT nX,
  484.                                             SHORT nY)
  485. {
  486.   // Only echo drawing action if we are not the current Master.
  487.   if (!m_pCO->m_pGuiPaper->Master())
  488.   {
  489.     // Play the data back to the CGuiPaper for display only.
  490.     m_pCO->m_pGuiPaper->InkDraw(nX, nY);
  491.   }
  492.  
  493.   return NOERROR;
  494. }
  495.  
  496.  
  497. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  498.   Method:   COPaperSink::CImpIPaperSink::InkStop
  499.  
  500.   Summary:  Client is being told to stop an ink drawing sequence.
  501.  
  502.   Args:     SHORT nX,
  503.               X coordinate of the start point.
  504.             SHORT nY,
  505.               Y coordinate of the start point.
  506.  
  507.   Returns:  HRESULT
  508.               Standard result code. NOERROR for success.
  509. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  510. STDMETHODIMP COPaperSink::CImpIPaperSink::InkStop(
  511.                                             SHORT nX,
  512.                                             SHORT nY)
  513. {
  514.   // Only echo drawing action if we are not the current Master.
  515.   if (!m_pCO->m_pGuiPaper->Master())
  516.   {
  517.     // Stop the play of the data back to the CGuiPaper for display.
  518.     m_pCO->m_pGuiPaper->InkStop(nX, nY);
  519.   }
  520.  
  521.   return NOERROR;
  522. }
  523.  
  524.  
  525. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  526.   Method:   COPaperSink::CImpIPaperSink::Erased
  527.  
  528.   Summary:  The COPaper object's drawing paper data was erased by a client.
  529.  
  530.   Args:     void
  531.  
  532.   Returns:  HRESULT
  533.               Standard result code. NOERROR for success.
  534. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  535. STDMETHODIMP COPaperSink::CImpIPaperSink::Erased(
  536.                void)
  537. {
  538.   HRESULT hr = E_FAIL;
  539.  
  540.   // Only echo drawing action if we are not the current Master.
  541.   if (!m_pCO->m_pGuiPaper->Master())
  542.     hr = m_pCO->m_pGuiPaper->Erase();
  543.  
  544.   return hr;
  545. }
  546.  
  547.  
  548. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  549.   Method:   COPaperSink::CImpIPaperSink::Resized
  550.  
  551.   Summary:  The COPaper object's drawing rectangle was resized by a client.
  552.  
  553.   Args:     LONG lWidth,
  554.               Rectangle width in pixels.
  555.             LONG lHeight)
  556.               Rectangle height in pixels.
  557.  
  558.   Returns:  HRESULT
  559.               Standard result code. NOERROR for success.
  560. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  561. STDMETHODIMP COPaperSink::CImpIPaperSink::Resized(
  562.                LONG lWidth,
  563.                LONG lHeight)
  564. {
  565.   HRESULT hr = E_FAIL;
  566.  
  567.   // Only echo drawing action if we are not the current Master.
  568.   if (!m_pCO->m_pGuiPaper->Master())
  569.     hr = m_pCO->m_pGuiPaper->Resize(lWidth, lHeight);
  570.  
  571.   return hr;
  572. }
  573.