共用方式為

OleNoteObjectVisible 函式 (ole2.h)

  • 發行項

遞增或遞減外部參考，讓物件保持執行中狀態。

語法

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

參數

[in] pUnknown

物件上要鎖定或解除鎖定之 IUnknown 介面的指標。

[in] fVisible

物件是否可見。 如果 為 TRUE，則 OLE 會遞增參考計數，以保留對象可見且運作，而不論外部或內部 IUnknown：：AddRef：：AddRef和 IUnknown：：Release 作業、註冊或撤銷。 如果 為 FALSE，OLE 會釋放其保留， (遞減參考計數) ，而且可以關閉物件。

傳回值

此函式會在成功時傳回S_OK。 其他可能的值包括下列專案。

傳回碼 Description
E_OUTOFMEMORY
 作業的記憶體不足。
E_INVALIDARG
 一或多個參數無效。
E_UNEXPECTED
 發生意外錯誤。

備註

OleNoteObjectVisible 函式會呼叫 CoLockObjectExternal 函式。 它以個別函式的形式提供，以強化使用者看得見物件時鎖定物件的需求，以及在物件變成不可見時釋放物件的需求。 這會代表使用者建立強式鎖定，以確保對象在可見時無法由其容器關閉。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 ole2.h
程式庫 Ole32.lib
Dll Ole32.dll

另請參閱

CoLockObjectExternal