OleLockRunning-Funktion (ole2.h)

Sperrt ein bereits ausgeführtes Objekt in den Ausführungszustand oder entsperrt es aus dem Ausführungszustand.

Syntax

HRESULT OleLockRunning(
  [in] LPUNKNOWN pUnknown,
  [in] BOOL      fLock,
  [in] BOOL      fLastUnlockCloses
);

Parameter

[in] pUnknown

Zeiger auf die IUnknown-Schnittstelle für das -Objekt, das die Funktion verwendet, um einen Zeiger auf IRunnableObject abzufragen.

[in] fLock

TRUE sperrt das Objekt in den Ausführungszustand. FALSE entsperrt das Objekt aus dem Ausführungszustand.

[in] fLastUnlockCloses

TRUE gibt an, dass das Objekt geschlossen werden soll, wenn es sich bei der freigegebenen Verbindung um die letzte externe Sperre für das Objekt handelt. FALSE gibt an, dass das Objekt geöffnet bleiben soll, bis es vom Benutzer oder einem anderen Prozess geschlossen wird.

Rückgabewert

Diese Funktion gibt bei Erfolg S_OK zurück. Weitere mögliche Werte sind:

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher für den Vorgang.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Die OleLockRunning-Funktion erspart Ihnen das Aufrufen der IRunnableObject::LockRunning-Methode . Sie können OleLockRunning und IRunnableObject::LockRunning austauschbar verwenden. Wenn der IUnknown-Zeiger mit dem pUnknown-Parameter übergeben wird, fragt OleLockRunning nach einem IRunnableObject-Zeiger ab. Bei erfolgreicher Ausführung wird IRunnableObject::LockRunning aufgerufen und die Ergebnisse des Aufrufs zurückgegeben.

Weitere Informationen zur Verwendung dieser Funktion finden Sie unter IRunnableObject::LockRunning.

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	ole2.h
Bibliothek	Ole32.lib
DLL	Ole32.dll

Weitere Informationen

CoLockObjectExternal

IRunnableObject::LockRunning

OleNoteObjectVisible