Função OleNoteObjectVisible (ole2.h)

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.

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

Confira também

Colockobjectexternal