Función CreateResourceManager (ktmw32.h)

Crea un nuevo objeto de Administrador de recursos (RM) y asocia el administrador de transacciones a un administrador de transacciones (TM).

Sintaxis

HANDLE CreateResourceManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpResourceManagerAttributes,
  [in]           LPGUID                ResourceManagerId,
  [in, optional] DWORD                 CreateOptions,
  [in]           HANDLE                TmHandle,
  [in, optional] LPWSTR                Description
);

Parámetros

[in, optional] lpResourceManagerAttributes

Puntero a una estructura de SECURITY_ATTRIBUTES que contiene los atributos de seguridad del administrador de recursos. Especifique NULL para obtener los atributos predeterminados.

[in] ResourceManagerId

Puntero al GUID del administrador de recursos. Este parámetro es obligatorio y no debe ser NULL.

[in, optional] CreateOptions

Cualquier atributo opcional para el nuevo RM.

[in] TmHandle

Identificador del TM que administrará las transacciones de este RM.

[in, optional] Description

Descripción de este RM.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es un identificador para rm.

Si se produce un error en la función, el valor devuelto es INVALID_HANDLE_VALUE. Para obtener información ampliada de los errores, llame a la función GetLastError.

En la lista siguiente se identifican los posibles códigos de error:

Comentarios

Inmediatamente después de llamar a esta función, debe llamar a RecoverResourceManager.

Un RM es un punto de conexión para las notificaciones de TM con respecto a las transacciones en las que el RM se ha inscrito.

Las máquinas virtuales suelen ser persistentes, lo que significa que, después de un error del sistema, deben volver a abrirse para realizar determinadas operaciones. Las máquinas virtuales volátiles o transitorias se pueden crear llamando a la función CreateResourceManager y especificando RESOURCE_MANAGER_VOLATILE. Las máquinas virtuales volátiles no realizan operaciones de recuperación, pero requieren notificaciones sobre una transacción.

Puede crear un RM volátil en un TM duradero, pero no puede crear un RM duradero en un TM volátil.

Requisitos

Consulte también

Funciones del Administrador de transacciones de kernel

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort