CreateResourceManager, fonction (ktmw32.h)
Crée un objet Resource Manager (RM) et associe le 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 resource manager. 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 pour le tm qui gérera les transactions pour ce RM.
[in, optional] Description
Description de ce rm.
Valeur retournée
Si la fonction réussit, la valeur de retour est un handle pour le rm.
Si la fonction échoue, la valeur de retour est INVALID_HANDLE_VALUE. Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.
La liste suivante identifie les codes d’erreur possibles :
Remarques
Immédiatement après l’appel de cette fonction, vous devez appeler RecoverResourceManager.
Un RM est un point de terminaison pour les notifications TM concernant les transactions dans lesquelles le RM a 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 sur une transaction.
Vous pouvez créer un RM volatile sur une TM durable, mais vous ne pouvez pas créer de RM durable sur une RM volatile.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista |
Serveur minimal pris en charge | Windows Server 2008 |
Plateforme cible | Windows |
En-tête | ktmw32.h |
Bibliothèque | Ktmw32.lib |
DLL | Ktmw32.dll |