ITextStoreAnchor::GetEmbedded method (textstor.h)
The ITextStoreAnchor::GetEmbedded method obtains an embedded object from a text stream.
HRESULT GetEmbedded( [in] DWORD dwFlags, [in] IAnchor *paPos, [in] REFGUID rguidService, [in] REFIID riid, [out] IUnknown **ppunk );
Bit fields that specify how the method deals with hidden text. If set to TS_GEA_HIDDEN, an embedded object can be located within hidden text. Otherwise hidden text is skipped over.
Pointer to an anchor positioned immediately in front of the embedded object, as denoted by a TS_CHAR_EMBEDDED character.
Contains a GUID value that defines the requested format of the obtained object. This can be one of the following values.
||The object should be obtained as an IDataObject data object.|
||The object should be obtained as an Accessible object.|
||The object should be obtained as an ActiveX object.|
Specifies the interface type requested.
Pointer to an IUnknown pointer that receives the requested interface.
This method can return one of these values.
||The method was successful.|
||The method failed to obtain the requested object.|
||One or more parameters are invalid.|
||The implementing application does not expose embedded objects in its text stream.|
||The requested paPos anchor is not within the document.|
||The requested interface type is unsupported.|
||The caller does not have a read-only lock.|
||There is no paPos anchor immediately in front of a TS_CHAR_EMBEDDED character.|
||The service type specified in rguidService is unsupported.|
The caller must use QueryInterface to probe for appropriate interfaces. Prospective interfaces include those associated with embedded documents or controls such as IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache, or IDispatch.
|Minimum supported client||Windows 2000 Professional [desktop apps | UWP apps]|
|Minimum supported server||Windows 2000 Server [desktop apps | UWP apps]|
|Redistributable||TSF 1.0 on Windows 2000 Professional|