Freigeben über


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