ICoCreateLocally::CoCreateLocally-Methode (msaatext.h)
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.
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 |
---|---|
|
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 |