Função OleNoteObjectVisible (ole2.h)

  • Artigo

Incrementa ou diminui uma referência externa que mantém um objeto no estado em execução.

Sintaxe

HRESULT OleNoteObjectVisible(
  [in] LPUNKNOWN pUnknown,
  [in] BOOL      fVisible
);

Parâmetros

[in] pUnknown

Ponteiro para a interface IUnknown no objeto que deve ser bloqueado ou desbloqueado.

[in] fVisible

Se o objeto está visível. Se TRUE, o OLE incrementa a contagem de referência para manter o objeto visível e ativo, independentemente das operações externas ou internas IUnknown::AddRef e IUnknown::Release , registros ou revogação. Se FALSE, o OLE liberará sua retenção (diminui a contagem de referência) e o objeto poderá ser fechado.

Retornar valor

Essa função retorna S_OK com ê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 OleNoteObjectVisible chama a função CoLockObjectExternal . Ele é fornecido como uma função separada para reforçar a necessidade de bloquear um objeto quando ele se torna visível para o usuário e para liberar o objeto quando ele se torna invisível. Isso cria um bloqueio forte em nome do usuário para garantir que o objeto não possa ser fechado por seu contêiner enquanto estiver visí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 ole2.h
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

Colockobjectexternal