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 |
|---|---|
|
Unzureichender Arbeitsspeicher für den Vorgang. |
|
Mindestens ein Parameter ist ungültig. |
|
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 |