Funzione OleNoteObjectVisible (ole2.h)

Incrementa o decrementa un riferimento esterno che mantiene un oggetto nello stato di esecuzione.

Sintassi

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

Parametri

[in] pUnknown

Puntatore all'interfaccia IUnknown sull'oggetto che deve essere bloccato o sbloccato.

[in] fVisible

Indica se l'oggetto è visibile. Se TRUE, OLE incrementa il conteggio dei riferimenti per contenere l'oggetto visibile e attivo indipendentemente dalle operazioni IUnknown::AddRef e IUnknown::Release , registrazioni o revoca esterne o interne. Se FALSE, OLE rilascia il relativo blocco (decrementa il conteggio dei riferimenti) e l'oggetto può essere chiuso.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Commenti

La funzione OleNoteObjectVisible chiama la funzione CoLockObjectExternal . Viene fornito come funzione separata per rafforzare la necessità di bloccare un oggetto quando diventa visibile all'utente e rilasciare l'oggetto quando diventa invisibile. In questo modo viene creato un blocco sicuro per conto dell'utente per assicurarsi che l'oggetto non possa essere chiuso dal contenitore mentre è visibile.

Requisiti

Vedi anche

CoLockObjectExternal