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         
                                                                                                          

   );                                                                                                     
                                                                                                          

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