IOleItemContainer::IsRunning-Methode (oleidl.h)

  • Artikel

Bestimmt, ob das angegebene Objekt ausgeführt wird.

Syntax

HRESULT IsRunning(
  [in] LPOLESTR pszItem
);

Parameter

[in] pszItem

Der Name des Containers für das Objekt.

Rückgabewert

Diese Methode kann die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Das Objekt wird ausgeführt.
S_FALSE
 Das Objekt wird nicht ausgeführt.
MK_E_NOOBJECT
 Der Parameter identifiziert kein Objekt in diesem Container.

Hinweise

Die Elementmonikerimplementierung von IMoniker::IsRunning ruft diese Methode auf.

Hinweise zu Implementierern

Ihre Implementierung von IOleItemContainer::IsRunning sollte zunächst bestimmen, ob pszItem eines der Objekte des Containers identifiziert. Andernfalls sollte Ihre Implementierung MK_E_NOOBJECT zurückgeben. Wenn das Objekt nicht geladen wird, sollte Ihre Implementierung S_FALSE zurückgeben. Wenn sie geladen wird, kann Ihre Implementierung die OleIsRunning-Funktion aufrufen, um zu bestimmen, ob sie ausgeführt wird.

Wenn pszItem ein Pseudoobjekt benennt, kann Ihre Implementierung einfach S_OK zurückgeben, da ein Pseudoobjekt immer ausgeführt wird, wenn sein Container ausgeführt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile oleidl.h

Weitere Informationen

IOleItemContainer