Función OleLockRunning (ole2.h)

Bloquea un objeto que ya se está ejecutando en su estado de ejecución o lo desbloquea desde su estado de ejecución.

Sintaxis

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

Parámetros

[in] pUnknown

Puntero a la interfaz IUnknown en el objeto , que la función usa para consultar un puntero a IRunnableObject.

[in] fLock

TRUE bloquea el objeto en su estado de ejecución. FALSE desbloquea el objeto desde su estado de ejecución.

[in] fLastUnlockCloses

TRUE especifica que si la conexión que se libera es el último bloqueo externo del objeto, el objeto debe cerrarse. FALSE especifica que el objeto debe permanecer abierto hasta que el usuario u otro proceso cierren.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles incluyen lo siguiente.

Código devuelto	Descripción
E_OUTOFMEMORY	Memoria insuficiente para la operación.
E_INVALIDARG	Uno o varios parámetros no son válidos.
E_UNEXPECTED	Se ha producido un error inesperado.

Comentarios

La función OleLockRunning le ahorra el problema de llamar al método IRunnableObject::LockRunning . Puede usar OleLockRunning e IRunnableObject::LockRunning indistintamente. Con el puntero IUnknown pasado con el parámetro pUnknown , OleLockRunning consulta un puntero IRunnableObject . Si se ejecuta correctamente, llama a IRunnableObject::LockRunning y devuelve los resultados de la llamada.

Para obtener más información sobre el uso de esta función, vea IRunnableObject::LockRunning.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ole2.h
Library	Ole32.lib
Archivo DLL	Ole32.dll

Consulte también

CoLockObjectExternal

IRunnableObject::LockRunning

OleNoteObjectVisible