Método IRunnableObject::LockRunning (objidl.h)

  • Artículo

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

Sintaxis

HRESULT LockRunning(
  [in] BOOL fLock,
  [in] BOOL fLastUnlockCloses
);

Parámetros

[in] fLock

TRUE bloquea el objeto en su estado en 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 en el objeto, el objeto debe cerrarse. FALSE especifica que el objeto debe permanecer abierto hasta que el usuario u otro proceso cierren.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL y S_OK.

Comentarios

La mayoría de las implementaciones de IRunnableObject::LockRunning llaman a CoLockObjectExternal.

OleLockRunning es una función auxiliar que vuelve a empaquetar convenientemente la funcionalidad que ofrece IRunnableObject::LockRunning. Con el lanzamiento de OLE 2.01, la implementación de OleLockRunning se cambió para llamar a QueryInterface, pedir IRunnableObject y, a continuación, llamar a IRunnableObject::LockRunning. En otras palabras, puede usar la interfaz y la función auxiliar indistintamente.

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 objidl.h

Consulte también

CoLockObjectExternal

IRunnableObject

OleLockRunning