Metode IDataObject::QueryGetData (objidl.h)

  • Artikel

Menentukan apakah objek data mampu merender data seperti yang ditentukan. Objek yang mencoba menempelkan atau menghilangkan operasi dapat memanggil metode ini sebelum memanggil IDataObject::GetData untuk mendapatkan indikasi apakah operasi mungkin berhasil.

Sintaks

HRESULT QueryGetData(
  [in] FORMATETC *pformatetc
);

Parameter

[in] pformatetc

Penunjuk ke struktur FORMATETC yang menentukan format, sedang, dan perangkat target yang akan digunakan untuk kueri.

Nilai kembali

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

Menampilkan kode Deskripsi
DV_E_LINDEX
 Nilai tidak valid untuk lindex; saat ini, hanya -1 yang didukung.
DV_E_FORMATETC
 Nilai tidak valid untuk pformatetc.
DV_E_TYMED
 Nilai yang di-tymed tidak valid.
DV_E_DVASPECT
 Nilai dwAspect tidak valid.
OLE_E_NOTRUNNING
 Aplikasi objek tidak berjalan.
E_UNEXPECTED
 Terjadi kesalahan tidak terduga.
E_INVALIDARG
 Nilai dwDirection tidak valid.
E_OUTOFMEMORY
 Tidak tersedia cukup memori untuk operasi ini.

Keterangan

Klien objek data memanggil QueryGetData untuk menentukan apakah meneruskan struktur FORMATETC yang ditentukan ke panggilan berikutnya ke IDataObject::GetData kemungkinan akan berhasil. Pengembalian yang berhasil dari metode ini tidak selalu memastikan keberhasilan operasi tempel atau hilangkan berikutnya.

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

Lihat juga

IDataObject