Compartir a través de

Función OleLockRunning (ole2.h)

  • Artículo

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