Método ITextStoreACP::GetEmbedded (textstor.h)

Obtém um documento inserido.

Sintaxe

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

Parâmetros

[in] acpPos

Contém a posição do caractere, dentro do documento, de onde o objeto é obtido.

[in] rguidService

Contém um valor GUID que define o formato solicitado do objeto obtido. Esse pode ser um dos valores a seguir.

Valor	Significado
GUID_TS_SERVICE_DATAOBJECT	O objeto deve ser obtido como um objeto IDataObject .
GUID_TS_SERVICE_ACCESSIBLE	O objeto deve ser obtido como um objeto Accessible.
GUID_TS_SERVICE_ACTIVEX	O objeto deve ser obtido como um objeto ActiveX.

[in] riid

Especifica o tipo de interface solicitado.

[out] ppunk

Ponteiro para um ponteiro IUnknown que recebe a interface solicitada.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
E_NOTIMPL	O aplicativo não dá suporte a objetos inseridos.
TF_E_INVALIDPOS	acpPos não está dentro do documento.
TS_E_NOINTERFACE	O tipo de interface solicitado não tem suporte.
TS_E_NOLOCK	O chamador não tem um bloqueio somente leitura.
TS_E_NOOBJECT	Não há nenhum objeto inserido em acpPos.
TS_E_NOSERVICE	O tipo de serviço especificado em rguidService não tem suporte.

Comentários

O chamador deve usar QueryInterface para investigar interfaces apropriadas. As interfaces em potencial incluem aquelas associadas a documentos ou controles inseridos, como IOleObject , IDataObject , IViewObject , IPersistStorage , IOleCache ou IDispatch .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	textstor.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional

Confira também

Objetos acessíveis

Idataobject

Itextstoreacp