Função OleLockRunning (ole2.h)

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

Sintaxe

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

Parâmetros

[in] pUnknown

Ponteiro para a interface IUnknown no objeto , que a função usa para consultar um ponteiro para IRunnableObject.

[in] fLock

TRUE bloqueia o objeto em seu estado de execução. FALSE desbloqueia o objeto de seu estado de 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

Essa função retorna S_OK em caso de êxito. Outros valores possíveis incluem o seguinte.

Código de retorno	Descrição
E_OUTOFMEMORY	Memória insuficiente para a operação.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
E_UNEXPECTED	Erro inesperado.

Comentários

A função OleLockRunning economiza o problema de chamar o método IRunnableObject::LockRunning . Você pode usar OleLockRunning e IRunnableObject::LockRunning intercambiável. Com o ponteiro IUnknown passado com o parâmetro pUnknown , OleLockRunning consulta um ponteiro IRunnableObject . Se tiver êxito, ele chamará IRunnableObject::LockRunning e retornará os resultados da chamada.

Para obter mais informações sobre como usar essa função, consulte IRunnableObject::LockRunning.

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	ole2.h
Biblioteca	Ole32.lib
DLL	Ole32.dll

Confira também

Colockobjectexternal

IRunnableObject::LockRunning

OleNoteObjectVisible