IOleDocumentSite Interface

IID_IOleDocumentSite

{B722BCC7-4E68-101B-A2BC-00AA00404770}

The IOleDocumentSite interface enables a document that has been implemented as a document object to bypass the normal activation sequence for in-place-active objects and to directly instruct its client site to activate it as a document object. A client site with this ability is called a document site.

For each document object to be hosted, a container must provide a corresponding document site, which is an OLE Documents client site that, in addition to implementing IOleClientSite and IAdviseSink, also implements IOleDocumentSite. Each document site implements a separate document view site object for each view of a document to be activated. The document view site implements IOleInPlaceSite and, optionally, IContinueCallback.

A document object calls IOleDocumentSite::ActivateMe to ask its document site to activate it, typically in response to the container's call to IOleObject::DoVerb.
 

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IOleDocumentSite Methods

Description

ActivateMe

Activates an OLE Document Object.

ActivateMe

FUNCTION IOleDocumentSite_ActivateMe ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL pViewToActivate AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IOleDocumentSite_ActivateMe (pthis, pViewToActivate) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION