ICoCreateLocally::CoCreateLocally-Methode (msaatext.h)

Artikel
02/29/2024

Clients rufen ICoCreateLocally::CoCreateLocally auf, um ein Hilfsobjekt im gleichen Kontext wie das Serverobjekt zu erstellen. Dadurch können Clients die Leistung erhöhen, da sie in der Serveranwendung ausgeführt werden.

Hinweis Active Accessibility Text Services ist veraltet. Informationen finden Sie unter:
Microsoft Windows Text Services Framework enthält weitere Informationen zu erweiterten Texteingabe- und Natürlichsprachtechnologien.

Syntax

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

Parameter

[in] rclsid

Typ: REFCLSID

Klassenbezeichner des lokal zu erstellenden Objekts.

[in] dwClsContext

Typ: DWORD

Kontext, in dem das Hilfsobjekt ausgeführt werden soll. Dies ist in der Regel CLSCTX_INPROC_SERVER.

[in] riid

Typ: REFIID

Der gewünschte Schnittstellenbezeichner (IID).

[out] punk

Typ: IUnknown*

Schnittstellenzeiger auf den gewünschten Schnittstellenbezeichner (von riid).

[in] riidParam

Typ: REFIID

Ein optionaler Schnittstellenparameter, der an das neue Hilfsobjekt übergeben wird. Dieser Parameter gibt einen Schnittstellenbezeichner an.

[in] punkParam

Typ: IUnknown*

Ein optionaler Schnittstellenparameter, der an das neue Hilfsobjekt übergeben wird. Dieser Parameter gibt den Schnittstellenzeiger an.

[in] varParam

Typ: VARIANT

Ein optionaler Schnittstellenparameter, der an das neue Hilfsobjekt übergeben wird.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Wenn dies nicht erfolgreich ist, wird der folgende Wert oder ein anderer COM-Standardfehlercode zurückgegeben.

Fehler	BESCHREIBUNG
E_ACCESSDENIED	Der Client verfügt nicht über ausreichende Berechtigungen, um dieses Objekt im Serverprozess zu erstellen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msaatext.h
DLL	Msaatext.dll
Verteilbare Komponente	Active Accessibility 2.0 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 98

Share via