IOleDocumentView::GetInPlaceSite

Retrieves the view site associated with this view object.

HRESULT GetInPlaceSite(
  IOleInPlaceSite **ppIPSite  //Address of output variable that 
                              // receives the IOleInPlaceSite interface 
                              // pointer
);
 

Parameters

ppIPSite
[out] Address of IOleInPlaceSite* pointer variable that receives the interface pointer to the document's view site.

Return Values

This method supports the standard return value E_FAIL, as well as the following:

S_OK
The interface pointer was returned successfully.

Remarks

GetInPlaceSite obtains the most recent IOleInPlaceSite pointer passed by IOleDocumentView::SetInPlaceSite, or NULL if SetInPlaceSite has not yet been called. If this pointer is not NULL, this method will call AddRef on the pointer. The caller is responsible for releasing it. A document view must implement this method completely; E_NOTIMPL is not an acceptable return value.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in docobj.h.

See Also

IOleDocumentView::SetInPlaceSite, IOleInPlaceSite