Metode IOleCommandTarget::QueryStatus (docobj.h)

Artikel
08/23/2023

Mengkueri objek untuk status satu atau beberapa perintah yang dihasilkan oleh peristiwa antarmuka pengguna.

Sintaks

HRESULT QueryStatus(
  [in]      const GUID *pguidCmdGroup,
  [in]      ULONG      cCmds,
  [in, out] OLECMD []  prgCmds,
  [in, out] OLECMDTEXT *pCmdText
);

Parameter

[in] pguidCmdGroup

Pengidentifikasi unik grup perintah; dapat berupa NULL untuk menentukan grup standar. Semua perintah yang diteruskan dalam array prgCmds harus termasuk dalam grup yang ditentukan oleh pguidCmdGroup.

[in] cCmds

Jumlah perintah dalam array prgCmds .

[in, out] prgCmds

Array struktur OLECMD yang dialokasikan penelepon yang menunjukkan perintah di mana pemanggil membutuhkan informasi status. Metode ini mengisi anggota cmdf dari setiap struktur dengan nilai yang diambil dari enumerasi OLECMDF .

[in, out] pCmdText

Penunjuk ke struktur OLECMDTEXT untuk mengembalikan informasi nama dan/atau status dari satu perintah. Parameter ini dapat berupa NULL untuk menunjukkan bahwa pemanggil tidak memerlukan informasi ini.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
E_FAIL	Operasi gagal.
E_UNEXPECTED	Terjadi kesalahan tidak terduga.
E_POINTER	Argumen prgCmds adalah NULL.
OLECMDERR_E_UNKNOWNGROUP	Parameter pguidCmdGroup bukan NULL tetapi tidak menentukan grup perintah yang dikenali.

Keterangan

Penelepon menggunakan QueryStatus untuk menentukan perintah mana yang didukung oleh objek target. Pemanggil kemudian dapat menonaktifkan perintah yang tidak tersedia yang jika tidak akan dirutekan ke objek. Pemanggil juga dapat menggunakan metode ini untuk mendapatkan nama atau status satu perintah.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	docobj.h

Lihat juga

Bagikan melalui