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

Article
03/04/2024

Les clients appellent ICoCreateLocally ::CoCreateLocally pour créer un objet d’assistance dans le même contexte que l’objet serveur. Cela permet aux clients d’augmenter les performances, car ils s’exécutent dans l’application serveur.

Note Active Accessibility Text Services est déconseillé. Consultez
Microsoft Windows Text Services Framework pour plus d’informations sur les technologies avancées d’entrée de texte et de langage naturel.

Syntaxe

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

Paramètres

[in] rclsid

Type : REFCLSID

Identificateur de classe de l’objet à créer localement.

[in] dwClsContext

Type : DWORD

Contexte dans lequel l’objet d’assistance doit s’exécuter. Cela est généralement CLSCTX_INPROC_SERVER.

[in] riid

Type : REFIID

Identificateur d’interface souhaité (IID).

[out] punk

Type : IUnknown*

Pointeur d’interface vers l’identificateur d’interface souhaité (à partir de riid).

[in] riidParam

Type : REFIID

Paramètre d’interface facultatif qui est passé au nouvel objet d’assistance. Ce paramètre spécifie un identificateur d’interface.

[in] punkParam

Type : IUnknown*

Paramètre d’interface facultatif qui est passé au nouvel objet d’assistance. Ce paramètre spécifie le pointeur d’interface.

[in] varParam

Type : VARIANT

Paramètre d’interface facultatif qui est passé au nouvel objet d’assistance.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK.

En cas d’erreur, retourne la valeur suivante ou un autre code d’erreur COM standard.

Erreur	Description
E_ACCESSDENIED	Le client ne dispose pas des autorisations suffisantes pour créer cet objet dans le processus serveur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msaatext.h
DLL	Msaatext.dll
Composant redistribuable	Active Accessibility 2.0 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 98

Share via