Metode ITextStoreAnchor::GetEmbedded (textstor.h)
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 |
---|---|
|
Objek harus diperoleh sebagai objek data IDataObject . |
|
Objek harus diperoleh sebagai objek Yang Dapat Diakses. |
|
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 |
---|---|
|
Metode berhasil. |
|
Metode gagal mendapatkan objek yang diminta. |
|
Satu atau beberapa parameter tidak valid. |
|
Aplikasi penerapan tidak mengekspos objek yang disematkan dalam aliran teksnya. |
|
Jangkar paPos yang diminta tidak berada dalam dokumen. |
|
Jenis antarmuka yang diminta tidak didukung. |
|
Penelepon tidak memiliki kunci baca-saja. |
|
Tidak ada jangkar paPos segera di depan karakter TS_CHAR_EMBEDDED. |
|
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 |