Contents Previous Page Next Page
IOleDocumentView::Close

Asks a document view to close and release its IOleInPlaceSite pointer.

HRESULT Close(

    DWORD
 dwReserved           // Reserved. Must be zero        
                                                                
   );                                                           
                                                                

Return Values

S_OK

The view successfully closed itself.

Remarks

The container must call this method before it wants to delete the view (that is, release its last reference to the view). In general, implementaion of this method will call IOleDocumentView::Show(FALSE) to hide the view if it is not already, then call IOleDocumentView::SetInPlaceSite(NULL) to deactivate itself and release the view site pointer.

Because Close is called when a container is going to completely shut down a view, this method must be implemented and has no reason to fail.

See Also

IOleDocumentView::SetInPlaceSite, IOleDocumentView::Show