ITextStoreAnchor::GetEmbedded-Methode (textstor.h)

Artikel
03/02/2024

Die ITextStoreAnchor::GetEmbedded-Methode ruft ein eingebettetes Objekt aus einem Textstream ab.

Syntax

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

Parameter

[in] dwFlags

Bitfelder, die angeben, wie die Methode mit ausgeblendetem Text umgeht. Wenn auf TS_GEA_HIDDEN festgelegt ist, kann sich ein eingebettetes Objekt in ausgeblendetem Text befinden. Andernfalls wird ausgeblendeter Text übersprungen.

[in] paPos

Zeiger auf einen Anker, der unmittelbar vor dem eingebetteten Objekt positioniert ist, wie durch ein TS_CHAR_EMBEDDED Zeichen gekennzeichnet.

[in] rguidService

Enthält einen GUID-Wert, der das angeforderte Format des abgerufenen Objekts definiert. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
GUID_TS_SERVICE_DATAOBJECT	Das Objekt sollte als IDataObject-Datenobjekt abgerufen werden.
GUID_TS_SERVICE_ACCESSIBLE	Das Objekt sollte als Barrierefreies Objekt abgerufen werden.
GUID_TS_SERVICE_ACTIVEX	Das Objekt sollte als ActiveX-Objekt abgerufen werden.

[in] riid

Gibt den angeforderten Schnittstellentyp an.

[out] ppunk

Zeiger auf einen IUnknown-Zeiger , der die angeforderte Schnittstelle empfängt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_FAIL	Die Methode konnte das angeforderte Objekt nicht abrufen.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
E_NOTIMPL	Die implementierenden Anwendungen machen keine eingebetteten Objekte in ihrem Textstream verfügbar.
TF_E_INVALIDPOS	Der angeforderte paPos-Anker befindet sich nicht im Dokument.
TS_E_NOINTERFACE	Der angeforderte Schnittstellentyp wird nicht unterstützt.
TS_E_NOLOCK	Der Aufrufer verfügt nicht über eine schreibgeschützte Sperre.
TS_E_NOOBJECT	Es gibt keinen paPos-Anker direkt vor einem TS_CHAR_EMBEDDED Zeichen.
TS_E_NOSERVICE	Der in rguidService angegebene Diensttyp wird nicht unterstützt.

Hinweise

Der Aufrufer muss QueryInterface verwenden, um die entsprechenden Schnittstellen zu testen. Zu den potenziellen Schnittstellen gehören solche, die eingebetteten Dokumenten oder Steuerelementen zugeordnet sind, z. B. IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache oder IDispatch.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	textstor.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

Barrierefreie Objekte

Idataobject

ITextStoreAnchor

Freigeben über