MTSCreateActivity-Funktion (comsvcs.h)

[MTSCreateActivity ist für in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die CoCreateActivity-Funktion .]

Erstellt eine Aktivität in einem Singlethread-Apartment, um synchrone oder asynchrone Batcharbeit zu erledigen.

Syntax

HRESULT MTSCreateActivity(
  [in]  REFIID riid,
  [out] void   **ppobj
);

Parameter

[in] riid

Die ID der Schnittstelle, die vom ppObj-Parameter zurückgegeben werden soll. Dieser Parameter sollte immer IID_IMTSActivity werden, damit ein Zeiger auf IMTSActivity zurückgegeben wird.

[out] ppobj

Ein Zeiger auf die Schnittstelle eines Aktivitätsobjekts. Das Aktivitätsobjekt wird automatisch durch den Aufruf von MTSCreateActivity erstellt.

Rückgabewert

Diese Methode kann die standardmäßigen Rückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_FAIL und S_OK zurückgeben.

Hinweise

MTSCreateActivity erstellt ein Aktivitätsobjekt, das zum Übermitteln von Batchvorgängen an das COM+-System verwendet wird. Die Batcharbeit, die über MTSCreateActivity übermittelt wird, kann entweder synchron oder asynchron sein und in einem Singlethreaded Apartment (STA) ausgeführt werden.

MTSCreateActivity gibt einen Zeiger auf die IMTSActivity-Schnittstelle des Objekts zurück, das durch den Aufruf von MTSCreateActivity erstellt wird. Mithilfe der Methoden von IMTSActivity bestimmen Sie, ob die Batcharbeit synchron oder asynchron erfolgt. Die Batcharbeit selbst wird über die IMTSCall-Schnittstelle implementiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	comsvcs.h
Bibliothek	ComSvcs.lib
DLL	ComSvcs.dll

Weitere Informationen

CoCreateActivity