Compartilhar via


Método IAccClientDocMgr::LookupByHWND (msaatext.h)

Os clientes chamam IAccClientDocMgr::LookupByHWND para obter um documento fornecendo o HWND para o documento.

Nota Os Serviços de Texto de Acessibilidade Ativa foram preteridos. Consulte Microsoft Windows Text Services Framework para obter mais informações sobre as tecnologias avançadas de entrada de texto e linguagem natural.
 

Sintaxe

HRESULT LookupByHWND(
  [in]  HWND     hWnd,
  [in]  REFIID   riid,
  [out] IUnknown **ppunk
);

Parâmetros

[in] hWnd

Tipo: HWND

O HWND do documento a ser retornado.

[in] riid

Tipo: REFIID

IID do documento que está sendo solicitado. Isso geralmente é IID_ITextStoreAnchor.

[out] ppunk

Tipo: IUnknown*

Ponteiro de interface para o documento que está sendo solicitado.

Valor retornado

Tipo: HRESULT

Se for bem-sucedido, retornará S_OK.

Se não for bem-sucedido, retornará o valor a seguir ou outro código de erro COM padrão.

Erro Descrição
E_FAIL
Se o HWND não corresponder a um documento ativo, ppunk será NULL.

Comentários

Talvez os servidores precisem sondar esse método mais de uma vez antes de receberem um documento. Pode haver um lapso de tempo limitado (aproximadamente segundo) entre quando um documento aparece no sistema e quando ele é registrado com serviços de documentos.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho msaatext.h
DLL Msaatext.dll
Redistribuível Active Accessibility 2.0 RDK no Windows NT 4.0 com SP6 e posterior e Windows 98