Metode IOleObject::GetMiscStatus (oleidl.h)

Artikel
03/01/2024

Mengambil status objek saat pembuatan dan pemuatan.

Sintaks

HRESULT GetMiscStatus(
  [in]  DWORD dwAspect,
  [out] DWORD *pdwStatus
);

Parameter

[in] dwAspect

Aspek objek tentang informasi status mana yang diminta. Nilai diperoleh dari enumerasi DVASPECT.

[out] pdwStatus

Penunjuk ke tempat informasi status dikembalikan. Parameter ini tidak boleh NULL.

Nilai kembali

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

Menampilkan kode	Deskripsi
OLE_S_USEREG	Delegasikan pengambilan informasi status lain-lain ke implementasi handler default dari metode ini.
CO_E_CLASSNOTREG	Tidak ada CLSID yang terdaftar untuk objek.
CO_E_READREGDB	Kesalahan saat mengakses registri.

Keterangan

Kontainer biasanya memanggil IOleObject::GetMiscStatus saat membuat atau memuat objek untuk menentukan cara menampilkan objek dan jenis perilaku apa yang didukungnya.

Objek menyimpan informasi status dalam registri. Jika objek tidak berjalan, implementasi handler default IOleObject::GetMiscStatus mengambil informasi ini dari registri. Jika objek berjalan, handler default memanggil IOleObject::GetMiscStatus pada objek itu sendiri.

Informasi yang benar-benar disimpan dalam registri bervariasi menurut objek individual. Nilai status yang akan dikembalikan ditentukan dalam enumerasi OLEMISC.

Nilai default IOleObject::GetMiscStatus digunakan jika subkunci yang sesuai dengan DVASPECT yang ditentukan tidak ditemukan. Untuk mengatur kontrol OLE, tentukan DVASPECT==1. Ini akan menyebabkan hal berikut terjadi di registri:

HKEY_CLASSES_ROOT\CLSID\ . . .
   MiscStatus = 1

Catatan untuk Pelaksana

Implementasi biasanya terdiri dari mendelegasikan panggilan ke handler default.

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	oleidl.h

Lihat juga

Bagikan melalui