Metodo ITextStoreAnchor::GetEmbedded (textstor.h)

Il metodo ITextStoreAnchor::GetEmbedded ottiene un oggetto incorporato da un flusso di testo.

Sintassi

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

Parametri

[in] dwFlags

Campi di bit che specificano il modo in cui il metodo gestisce il testo nascosto. Se impostato su TS_GEA_HIDDEN, un oggetto incorporato può trovarsi all'interno del testo nascosto. In caso contrario, il testo nascosto viene ignorato.

[in] paPos

Puntatore a un ancoraggio posizionato immediatamente davanti all'oggetto incorporato, come indicato da un carattere TS_CHAR_EMBEDDED.

[in] rguidService

Contiene un valore GUID che definisce il formato richiesto dell'oggetto ottenuto. Può trattarsi di uno dei valori seguenti.

Valore	Significato
GUID_TS_SERVICE_DATAOBJECT	L'oggetto deve essere ottenuto come oggetto dati IDataObject .
GUID_TS_SERVICE_ACCESSIBLE	L'oggetto deve essere ottenuto come oggetto Accessible.
GUID_TS_SERVICE_ACTIVEX	L'oggetto deve essere ottenuto come oggetto ActiveX.

[in] riid

Specifica il tipo di interfaccia richiesto.

[out] ppunk

Puntatore a un puntatore IUnknown che riceve l'interfaccia richiesta.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_FAIL	Il metodo non è riuscito a ottenere l'oggetto richiesto.
E_INVALIDARG	Uno o più parametri non sono validi.
E_NOTIMPL	L'applicazione che implementa non espone oggetti incorporati nel flusso di testo.
TF_E_INVALIDPOS	L'ancoraggio paPos richiesto non si trova all'interno del documento.
TS_E_NOINTERFACE	Il tipo di interfaccia richiesto non è supportato.
TS_E_NOLOCK	Il chiamante non dispone di un blocco di sola lettura.
TS_E_NOOBJECT	Non c'è alcun ancoraggio paPos immediatamente davanti a un carattere TS_CHAR_EMBEDDED.
TS_E_NOSERVICE	Il tipo di servizio specificato in rguidService non è supportato.

Commenti

Il chiamante deve usare QueryInterface per eseguire il probe delle interfacce appropriate. Le potenziali interfacce includono quelle associate a documenti o controlli incorporati, ad esempio IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache o IDispatch.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	textstor.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

Oggetti accessibili

Idataobject

ITextStoreAnchor