|
IRunnableObject::IsRunning
Determines whether an object is currently in the running state.
BOOL IsRunning();
Return Values
TRUE
The object is in the running state.
FALSE
The object is not in the running state.
Comments
A container application could call IRunnableObject::IsRunning when it needs to know if the server is immediately available. For example, a
container's implementation of the IOleItemContainer::GetObject method would return an error if the server is not running and the bindspeed
parameter specifies BINDSPEED_IMMEDIATE.
An object handler could call IRunnableObject::IsRunning when it wants to avoid conflicts with a running server or when the running
server might have more up-to-date information. For example, a handler's
implementation of IOleObject::GetExtent would delegate to the object server if it is running, because the server's
information might be more current than that in the handler's cache.
OleIsRunning is a helper function that conveniently repackages the functionality offered by IRunnableObject::IsRunning. With the release of OLE 2.01, the implementation of OleIsRunning was changed so that it calls QueryInterface, asks for IRunnableObject, and then calls IRunnableObject::IsRunning. In other words, you can use the interface and the helper function
interchangeably.
See Also
OleIsRunning
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
