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 |