OleNoteObjectVisible-Funktion (ole2.h)
Erhöht oder dekrementiert einen externen Verweis, der ein Objekt im Ausführungszustand hält.
Syntax
HRESULT OleNoteObjectVisible(
[in] LPUNKNOWN pUnknown,
[in] BOOL fVisible
);
Parameter
[in] pUnknown
Zeiger auf die IUnknown-Schnittstelle für das Objekt, das gesperrt oder entsperrt werden soll.
[in] fVisible
Gibt an, ob das Objekt sichtbar ist. Wenn TRUE, erhöht OLE die Verweisanzahl, um das Objekt sichtbar und lebendig zu halten, unabhängig von externen oder internen IUnknown::AddRef - und IUnknown::Release-Vorgängen , Registrierungen oder Sperrvorgängen. Wenn FALSE, gibt OLE seinen Halteraum frei (verringert die Verweisanzahl), und das Objekt kann geschlossen werden.
Rückgabewert
Diese Funktion gibt bei Erfolg S_OK zurück. Weitere mögliche Werte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Unzureichender Arbeitsspeicher für den Vorgang. |
|
Mindestens ein Parameter ist ungültig. |
|
Ein unerwarteter Fehler ist aufgetreten. |
Hinweise
Die OleNoteObjectVisible-Funktion ruft die CoLockObjectExternal-Funktion auf. Es wird als separate Funktion bereitgestellt, um die Notwendigkeit zu verstärken, ein Objekt zu sperren, wenn es für den Benutzer sichtbar wird, und um das Objekt zu freigeben, wenn es unsichtbar wird. Dadurch wird eine starke Sperre im Namen des Benutzers erstellt, um sicherzustellen, dass das Objekt nicht von seinem Container geschlossen werden kann, während es sichtbar ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ole2.h |
| Bibliothek | Ole32.lib |
| DLL | Ole32.dll |