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

Voir aussi

CoCréateActivity