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

  • Artigo

Bloqueia um objeto que já está em execução em seu estado de execução ou o desbloqueia de seu estado de execução.

Sintaxe

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

Parâmetros

[in] fLock

TRUE bloqueia o objeto em seu estado de execução. FALSE desbloqueia o objeto do estado em execução.

[in] fLastUnlockCloses

TRUE especifica que, se a conexão que está sendo liberada for o último bloqueio externo no objeto, o objeto deverá ser fechado. FALSE especifica que o objeto deve permanecer aberto até ser fechado pelo usuário ou outro processo.

Retornar valor

Esse método pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL e S_OK.

Comentários

A maioria das implementações de IRunnableObject::LockRunning chama CoLockObjectExternal.

OleLockRunning é uma função auxiliar que reempacota convenientemente a funcionalidade oferecida por IRunnableObject::LockRunning. Com o lançamento do OLE 2.01, a implementação de OleLockRunning foi alterada para chamar QueryInterface, solicitar IRunnableObject e, em seguida, chamar IRunnableObject::LockRunning. Em outras palavras, você pode usar a interface e a função auxiliar intercambiável.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho objidl.h

Confira também

Colockobjectexternal

Irunnableobject

OleLockRunning