OleIsRunning

Determines whether a compound document object is currently in the running state.

BOOL OleIsRunning(
  LPOLEOBJECT pObject  //Pointer to the interface
);
 

Parameter

pObject
[in] Pointer to the IOleObject interface on the object of interest.

Return Value

The return value is TRUE if the object is running; otherwise, it is FALSE.

Remarks

You can use OleIsRunning and IRunnableObject::IsRunning interchangeably. OleIsRunning queries the object for a pointer to the IRunnableObject interface and calls its IsRunning method. If successful, the function returns the results of the call to IRunnableObject::IsRunning.

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

Windows CE: Passing into this function any invalid and, under some circumstances, NULL pointers will result in unexpected termination of the application. For more information about handling exceptions, see Programming Considerations.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Use version 2.0 or later.
  Header: Declared in ole2.h.
  Import Library: Included as a resource in ole32.dll.

See Also

IRunnableObject::IsRunning