OleNoteObjectVisible-Funktion (ole2.h)

  • Artikel

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
E_OUTOFMEMORY
 Unzureichender Arbeitsspeicher für den Vorgang.
E_INVALIDARG
 Mindestens ein Parameter ist ungültig.
E_UNEXPECTED
 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

Weitere Informationen

CoLockObjectExternal