Fungsi OleNoteObjectVisible (ole2.h)

Artikel
02/29/2024

Kenaikan atau penurunan referensi eksternal yang menyimpan objek dalam status berjalan.

Sintaks

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

Parameter

[in] pUnknown

Arahkan ke antarmuka IUnknown pada objek yang akan dikunci atau dibuka kuncinya.

[in] fVisible

Apakah objek terlihat. Jika TRUE, OLE menambah jumlah referensi untuk menahan objek terlihat dan hidup terlepas dari IUnknown eksternal atau internal::AddRef dan IUnknown::Operasi rilis , pendaftaran, atau pencabutan. Jika FALSE, OLE merilis penahanannya (mengurangi jumlah referensi) dan objek dapat ditutup.

Nilai kembali

Fungsi ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Memori untuk operasi tidak cukup.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.
E_UNEXPECTED	Terjadi kesalahan tak terduga.

Keterangan

Fungsi OleNoteObjectVisible memanggil fungsi CoLockObjectExternal . Ini disediakan sebagai fungsi terpisah untuk memperkuat kebutuhan untuk mengunci objek ketika terlihat oleh pengguna dan untuk melepaskan objek ketika menjadi tidak terlihat. Ini menciptakan kunci yang kuat atas nama pengguna untuk memastikan bahwa objek tidak dapat ditutup oleh kontainernya saat terlihat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ole2.h
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

CoLockObjectExternal

Bagikan melalui