IOleDocumentView::GetInPlaceSite

Retrieves the most recent view site associated with this view of the document.

HRESULT GetInPlaceSite(

IOleInPlaceSite **ppIPSite

// On return, Indirect pointer to the document’s view site

);

Parameters

ppIPSite: [out] Pointer to the view site’s IOleInPlaceSite interface pointer.

Return Value

S_OK: The interface pointer was returned successfully.
E_FAIL: Another error occurred.

Remarks

Returns the most recent IOleInPlaceSite pointer passed in IOleDocumentView::SetInPlaceSite, or NULL if SetInPlaceSite has not yet been called. The view will call AddRef on this pointer before returning it, thus the caller must later call Release.

Notes to Callers

The caller is responsible incrementing the reference count on the interface pointer returned by this method. The caller must call Release through this pointer when it is no longer needed.

Notes to Implementers

A document view must implement this method completely. Therefore E_NOTIMPL is not an acceptable return value.

See Also

IOleDocumentView::SetInPlaceSite, IOleInPlaceSite

IOleInPlaceSite **ppIPSite	// On return, Indirect pointer to the document’s view site
);