OleRun

A version of this page is also available for

4/8/2010

This function puts an OLE compound document object into the running state.

Syntax

WINOLEAPI OleRun(
  LPUNKNOWN pUnknown
);

pUnknown
[in] Pointer to the IUnknown interface on the object, with which it will query for a pointer to the IRunnableObject interface, and then call its IRunnableObject::Run method.

The following HRESULT values can be returned.

Value	Description
S_OK	The object was placed in the running state.
OLE_E_CLASSDIFF	The source of an OLE link was converted to a different class.
E_INVALIDARG	The function failed.
E_OUTOFMEMORY	The function failed.

Passing invalid (and under some circumstances NULL) pointers into this function causes an unexpected termination of the application.

The OleRun function puts an object in the running state.

The implementation of OleRun was changed in OLE 2.01 to coincide with the publication of the IRunnableObject interface.

You can use OleRun and IRunnableObject::Run interchangeably.

OleRun queries the object for a pointer to IRunnableObject.

If successful, the function returns the results of calling the IRunnableObject::Run method.

The implementation of OleRun in earlier versions of OLE differs from that described here.

To determine whether the platform supports this function, see Determining Supported COM APIs.

Header	ole2.h
Library	ole32.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later