Bagikan melalui

Fungsi OleQueryCreateFromData (ole2.h)

Memeriksa apakah objek data memiliki salah satu format yang akan memungkinkannya menjadi objek yang disematkan melalui panggilan ke fungsi OleCreateFromData atau OleCreateStaticFromData .

Sintaks

HRESULT OleQueryCreateFromData(
  [in] LPDATAOBJECT pSrcDataObject
);

Parameter

[in] pSrcDataObject

Arahkan ke antarmuka IDataObject pada objek transfer data yang akan dikueri.

Nilai kembali

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

Menampilkan kode Deskripsi
S_FALSE
 Tidak ada format yang mendukung pembuatan objek statis atau tertanam.
OLE_S_STATIC
 Format yang mendukung pembuatan objek statis ada.

Keterangan

Ketika aplikasi mengambil objek transfer data melalui panggilan ke fungsi OleGetClipboard , aplikasi harus memanggil OleQueryCreateFromData sebagai bagian dari proses memutuskan untuk mengaktifkan atau menonaktifkan perintah Edit/Tempel atau Edit/Tempel Khusus... . Ini menguji keberadaan format berikut dalam objek data:

  • CF_EMBEDDEDOBJECT
  • CF_EMBEDSOURCE
  • cfFileName
  • CF_METAFILEPICT
  • CF_DIB
  • CF_BITMAP
  • CF_ENHMETAFILE
Menentukan bahwa objek data memiliki salah satu format ini tidak benar-benar menjamin bahwa pembuatan objek akan berhasil, tetapi dimaksudkan untuk membantu proses.

Jika OleQueryCreateFromData menemukan salah satu format CF_METAFILEPICT, CF_BITMAP, CF_DIB, atau CF_ENHMETAFILE dan tidak ada format lain, format tersebut mengembalikan OLE_S_STATIC, yang menunjukkan bahwa Anda harus memanggil fungsi OleCreateStaticFromData untuk membuat objek yang disematkan.

Jika OleQueryCreateFromData menemukan salah satu format lain (CF_EMBEDDEDOBJECT, CF_EMBEDSOURCE, atau cfFileName), bahkan dalam kombinasi dengan format statis, ia mengembalikan S_OK, menunjukkan bahwa Anda harus memanggil fungsi OleCreateFromData untuk membuat objek yang disematkan.

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
Set API ext-ms-win-com-ole32-l1-1-3 (diperkenalkan dalam Windows 10, versi 10.0.10240)

Lihat juga

OleCreateFromData

OleCreateStaticFromData

OleQueryLinkFromData

  • Last updated on