Función OleNoteObjectVisible (ole2.h)

  • Artículo

Incrementa o disminuye una referencia externa que mantiene un objeto en estado de ejecución.

Sintaxis

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

Parámetros

[in] pUnknown

Puntero a la interfaz IUnknown en el objeto que se va a bloquear o desbloquear.

[in] fVisible

Indica si el objeto está visible. Si es TRUE, OLE incrementa el recuento de referencias para contener el objeto visible y activo independientemente de las operaciones externas o internas de IUnknown::AddRef e IUnknown::Release , los registros o la revocación. Si es FALSE, OLE libera su suspensión (disminuye el recuento de referencias) y el objeto se puede cerrar.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles incluyen lo siguiente.

Código devuelto Descripción
E_OUTOFMEMORY
 Memoria insuficiente para la operación.
E_INVALIDARG
 Uno o varios parámetros no son válidos.
E_UNEXPECTED
 Se ha producido un error inesperado.

Comentarios

La función OleNoteObjectVisible llama a la función CoLockObjectExternal . Se proporciona como una función independiente para reforzar la necesidad de bloquear un objeto cuando se vuelve visible para el usuario y liberar el objeto cuando se vuelve invisible. Esto crea un bloqueo seguro en nombre del usuario para asegurarse de que su contenedor no puede cerrar el objeto mientras está visible.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ole2.h
Library Ole32.lib
Archivo DLL Ole32.dll

Consulte también

CoLockObjectExternal