Método ICoCreateLocally::CoCreateLocally (msaatext.h)

Artigo
08/24/2023

Os clientes chamam ICoCreateLocally::CoCreateLocally para criar um objeto auxiliar no mesmo contexto que o objeto de servidor. Isso permite que os clientes aumentem o desempenho porque estão em execução no aplicativo do servidor.

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

Sintaxe

HRESULT CoCreateLocally(
  [in]  REFCLSID rclsid,
  [in]  DWORD    dwClsContext,
  [in]  REFIID   riid,
  [out] IUnknown **punk,
  [in]  REFIID   riidParam,
  [in]  IUnknown *punkParam,
  [in]  VARIANT  varParam
);

Parâmetros

[in] rclsid

Tipo: REFCLSID

Identificador de classe do objeto a ser criado localmente.

[in] dwClsContext

Tipo: DWORD

Contexto no qual o objeto auxiliar deve ser executado. Isso geralmente é CLSCTX_INPROC_SERVER.

[in] riid

Tipo: REFIID

O IID (identificador de interface) desejado.

[out] punk

Tipo: IUnknown*

Ponteiro de interface para o identificador de interface desejado (de riid).

[in] riidParam

Tipo: REFIID

Um parâmetro de interface opcional que é passado para o novo objeto auxiliar. Esse parâmetro especifica um identificador de interface.

[in] punkParam

Tipo: IUnknown*

Um parâmetro de interface opcional que é passado para o novo objeto auxiliar. Esse parâmetro especifica o ponteiro da interface.

[in] varParam

Tipo: VARIANT

Um parâmetro de interface opcional que é passado para o novo objeto auxiliar.

Retornar valor

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_ACCESSDENIED	O cliente não tem permissões suficientes para criar esse objeto no processo do servidor.

Requisitos

Requisito	Valor
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

Share via