CreateResourceManager, fonction (ktmw32.h)

  • Article

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
RESOURCE_MANAGER_VOLATILE
 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

Voir aussi

Fonctions du gestionnaire de transactions du noyau

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort