Metode ITextStoreAnchor::GetEmbedded (textstor.h)

  • Artikel

Metode ITextStoreAnchor::GetEmbedded mendapatkan objek yang disematkan dari aliran teks.

Sintaks

HRESULT GetEmbedded(
  [in]  DWORD    dwFlags,
  [in]  IAnchor  *paPos,
  [in]  REFGUID  rguidService,
  [in]  REFIID   riid,
  [out] IUnknown **ppunk
);

Parameter

[in] dwFlags

Bidang bit yang menentukan bagaimana metode menangani teks tersembunyi. Jika diatur ke TS_GEA_HIDDEN, objek yang disematkan dapat berada di dalam teks tersembunyi. Jika tidak, teks tersembunyi dilewati.

[in] paPos

Penunjuk ke jangkar yang diposisikan langsung di depan objek yang disematkan, seperti yang ditandai dengan karakter TS_CHAR_EMBEDDED.

[in] rguidService

Berisi nilai GUID yang menentukan format yang diminta dari objek yang diperoleh. Ini bisa menjadi salah satu nilai berikut.

Nilai Makna
GUID_TS_SERVICE_DATAOBJECT
 Objek harus diperoleh sebagai objek data IDataObject .
GUID_TS_SERVICE_ACCESSIBLE
 Objek harus diperoleh sebagai objek Yang Dapat Diakses.
GUID_TS_SERVICE_ACTIVEX
 Objek harus diperoleh sebagai objek ActiveX.

[in] riid

Menentukan jenis antarmuka yang diminta.

[out] ppunk

Arahkan ke pointer IUnknown yang menerima antarmuka yang diminta.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Deskripsi
S_OK
 Metode berhasil.
E_FAIL
 Metode gagal mendapatkan objek yang diminta.
E_INVALIDARG
 Satu atau beberapa parameter tidak valid.
E_NOTIMPL
 Aplikasi penerapan tidak mengekspos objek yang disematkan dalam aliran teksnya.
TF_E_INVALIDPOS
 Jangkar paPos yang diminta tidak berada dalam dokumen.
TS_E_NOINTERFACE
 Jenis antarmuka yang diminta tidak didukung.
TS_E_NOLOCK
 Penelepon tidak memiliki kunci baca-saja.
TS_E_NOOBJECT
 Tidak ada jangkar paPos segera di depan karakter TS_CHAR_EMBEDDED.
TS_E_NOSERVICE
 Jenis layanan yang ditentukan dalam rguidService tidak didukung.

Keterangan

Pemanggil harus menggunakan QueryInterface untuk memeriksa antarmuka yang sesuai. Antarmuka prospektif mencakup yang terkait dengan dokumen atau kontrol yang disematkan seperti IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache, atau IDispatch.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header textstor.h
DLL Msctf.dll
Redistribusi TSF 1.0 di Windows 2000 Professional

Lihat juga

Objek yang Dapat Diakses

IDataObject

ITextStoreAnchor