CreateResourceManager, fonction (ktmw32.h)
Crée un objet Resource Manager (RM) et associe rm à un gestionnaire de transactions (TM).
Syntaxe
HANDLE CreateResourceManager(
[in, optional] LPSECURITY_ATTRIBUTES lpResourceManagerAttributes,
[in] LPGUID ResourceManagerId,
[in, optional] DWORD CreateOptions,
[in] HANDLE TmHandle,
[in, optional] LPWSTR Description
);
Paramètres
[in, optional] lpResourceManagerAttributes
Pointeur vers une structure SECURITY_ATTRIBUTES qui contient les attributs de sécurité du gestionnaire de ressources. Spécifiez NULL pour obtenir les attributs par défaut.
[in] ResourceManagerId
Pointeur du GUID du gestionnaire de ressources. Ce paramètre est obligatoire et ne doit pas être NULL.
[in, optional] CreateOptions
Tous les attributs facultatifs pour le nouveau RM.
| Valeur | Signification |
|---|---|
|
Indique que le RM est volatile et n’effectue pas de récupération. |
[in] TmHandle
Handle vers le tm qui gérera les transactions pour ce RM.
[in, optional] Description
Description de ce RM.
Valeur de retour
Si la fonction réussit, la valeur de retour est un handle vers rm.
Si la fonction échoue, la valeur de retour est INVALID_HANDLE_VALUE. Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError.
La liste suivante identifie les codes d’erreur possibles :
Remarques
Immédiatement après avoir appelé cette fonction, vous devez appeler RecoverResourceManager.
Un RM est un point de terminaison pour les notifications TM concernant les transactions dans lesquelles rm s’est inscrit.
Les machines virtuelles sont généralement persistantes, ce qui signifie qu’après une défaillance du système, elles doivent être rouvertes pour effectuer certaines opérations. Vous pouvez créer des machines virtuelles volatiles ou temporaires en appelant la fonction CreateResourceManager et en spécifiant RESOURCE_MANAGER_VOLATILE. Les machines virtuelles volatiles n’effectuent pas d’opérations de récupération, mais nécessitent des notifications concernant une transaction.
Vous pouvez créer un RM volatile sur une tm durable, mais vous ne pouvez pas créer un RM durable sur une tm volatile.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| serveur minimum pris en charge | Windows Server 2008 |
| plateforme cible | Windows |
| d’en-tête | ktmw32.h |
| bibliothèque | Ktmw32.lib |
| DLL | Ktmw32.dll |