Compartir a través de

Método ITextStoreAnchor::GetEmbedded (texttor.h)

  • Artículo

El método ITextStoreAnchor::GetEmbedded obtiene un objeto incrustado de una secuencia de texto.

Sintaxis

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

Parámetros

[in] dwFlags

Campos de bits que especifican cómo se ocupa el método con el texto oculto. Si se establece en TS_GEA_HIDDEN, un objeto incrustado se puede ubicar dentro del texto oculto. De lo contrario, se omite el texto oculto.

[in] paPos

Puntero a un delimitador situado inmediatamente delante del objeto incrustado, como se indica en un carácter de TS_CHAR_EMBEDDED.

[in] rguidService

Contiene un valor GUID que define el formato solicitado del objeto obtenido. Puede ser uno de los siguientes valores.

Valor Significado
GUID_TS_SERVICE_DATAOBJECT
 El objeto debe obtenerse como un objeto de datos IDataObject .
GUID_TS_SERVICE_ACCESSIBLE
 El objeto debe obtenerse como un objeto Accesible.
GUID_TS_SERVICE_ACTIVEX
 El objeto debe obtenerse como un objeto ActiveX.

[in] riid

Especifica el tipo de interfaz solicitado.

[out] ppunk

Puntero a un puntero IUnknown que recibe la interfaz solicitada.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Descripción
S_OK
 Método realizado correctamente.
E_FAIL
 El método no pudo obtener el objeto solicitado.
E_INVALIDARG
 Uno o varios parámetros no son válidos.
E_NOTIMPL
 La aplicación de implementación no expone objetos incrustados en su flujo de texto.
TF_E_INVALIDPOS
 El delimitador paPos solicitado no está dentro del documento.
TS_E_NOINTERFACE
 El tipo de interfaz solicitado no es compatible.
TS_E_NOLOCK
 El autor de la llamada no tiene un bloqueo de solo lectura.
TS_E_NOOBJECT
 No hay ningún delimitador paPos inmediatamente delante de un carácter de TS_CHAR_EMBEDDED.
TS_E_NOSERVICE
 El tipo de servicio especificado en rguidService no es compatible.

Comentarios

El autor de la llamada debe usar QueryInterface para sondear las interfaces adecuadas. Entre las posibles interfaces se incluyen las asociadas a documentos incrustados o controles como IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache o IDispatch.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado textstor.h
Archivo DLL Msctf.dll
Redistribuible TSF 1.0 en Windows 2000 Professional

Consulte también

Objetos accesibles

IDataObject

ITextStoreAnchor