ITextStoreACP::GetEmbedded-Methode (textstor.h)

Artikel
03/02/2024

Ruft ein eingebettetes Dokument ab.

Syntax

HRESULT GetEmbedded(
  [in]  LONG     acpPos,
  [in]  REFGUID  rguidService,
  [in]  REFIID   riid,
  [out] IUnknown **ppunk
);

Parameter

[in] acpPos

Enthält die Zeichenposition im Dokument, von der das Objekt abgerufen wird.

[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-Objekt 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_INVALIDARG	Mindestens ein Parameter ist ungültig.
E_NOTIMPL	Eingebettete Objekte werden von der Anwendung nicht unterstützt.
TF_E_INVALIDPOS	acpPos 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	In acpPos ist kein eingebettetes Objekt vorhanden.
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 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	textstor.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

Barrierefreie Objekte

Idataobject

Itextstoreacp

Freigeben über