IOleInPlaceSite::OnInPlaceDeactivate

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Notifies the container that the object is no longer active in place.

Syntax

HRESULT OnInPlaceDeactivate();

Return Value

This method supports the following return values:

Value Description

S_OK

The method successfully notified the container.

E_UNEXPECTED

The call to the method unexpectedly failed.

Notes to Callers

IOleInPlaceSite::OnInPlaceDeactivate is called by an in-place object when it is fully deactivated. This function notifies the container that the object has been deactivated, and it gives the container a chance to run code pertinent to the object's deactivation. In particular, IOleInPlaceSite::OnInPlaceDeactivate is called as a result of IOleInPlaceObject::InPlaceDeactivate being called. Calling IOleInPlaceSite::OnInPlaceDeactivate indicates that the object can no longer support Undo.

Notes to Implementers

If the container is holding pointers to the IOleInPlaceObject and IOleInPlaceActiveObject interface implementations, it should release them after the IOleInPlaceSite::OnInPlaceDeactivate call.

Requirements

Header Oleidl.h
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IOleInPlaceSite