IOleInPlaceSite::OnInPlaceDeactivate method (oleidl.h)

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

Syntax

HRESULT OnInPlaceDeactivate();

Return value

This method returns S_OK on success. Other possible return values include the following.

Return code Description
E_UNEXPECTED
An unexpected error has occurred.

Remarks

Notes to Callers

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, OnInPlaceDeactivate is called as a result of IOleInPlaceObject::InPlaceDeactivate being called. Calling 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 OnInPlaceDeactivate call.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header oleidl.h

See also

IOleInPlaceObject::InPlaceDeactivate

IOleInPlaceSite