Fonction MTSCreateActivity (comsvcs.h)
[MTSCreateActivity est disponible pour dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt la fonction CoCreateActivity .]
Crée une activité dans un appartement monothread pour effectuer un travail par lots synchrone ou asynchrone.
Syntaxe
HRESULT MTSCreateActivity(
[in] REFIID riid,
[out] void **ppobj
);
Paramètres
[in] riid
ID de l’interface à retourner par le paramètre ppObj . Ce paramètre doit toujours être IID_IMTSActivity afin qu’un pointeur vers IMTSActivity soit retourné.
[out] ppobj
Pointeur vers l’interface d’un objet d’activité. L’objet d’activité est automatiquement créé par l’appel à MTSCreateActivity.
Valeur retournée
Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY, E_FAIL et S_OK.
Remarques
MTSCreateActivity crée un objet d’activité qui est utilisé pour soumettre le travail par lots au système COM+. Le travail par lots envoyé via MTSCreateActivity peut être synchrone ou asynchrone et s’exécute dans un appartement à thread unique (STA).
MTSCreateActivity retourne un pointeur vers l’interface IMTSActivity de l’objet créé par l’appel à MTSCreateActivity. En utilisant les méthodes d’IMTSActivity, vous déterminez si le travail par lots est effectué de manière synchrone ou asynchrone. Le travail par lots lui-même est implémenté via l’interface IMTSCall .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | comsvcs.h |
| Bibliothèque | ComSvcs.lib |
| DLL | ComSvcs.dll |