Método IRunnableObject::LockRunning (objidl.h)
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 |