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.
| Codice restituito | Descrizione |
|---|---|
|
Memoria insufficiente per l'operazione. |
|
Uno o più parametri non sono validi. |
|
Si è verificato un errore imprevisto. |
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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ole2.h |
| Libreria | Ole32.lib |
| DLL | Ole32.dll |