Compartir a través de

Función CreateResourceManager (ktmw32.h)

  • Artículo

Crea un nuevo objeto de Resource Manager (RM) y asocia el RM 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 necesario y no debe ser NULL.

[in, optional] CreateOptions

Cualquier atributo opcional para el nuevo RM.

Valor Significado
RESOURCE_MANAGER_VOLATILE
 Indica que el RM es volátil y no realiza la recuperación.

[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 ejecuta correctamente, el valor devuelto es un identificador para rm.

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

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

Observaciones

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

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

Normalmente, las máquinas virtuales son 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 mediante una llamada a la función CreateResourceManager y especificando RESOURCE_MANAGER_VOLATILE. Las VM 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

Requisito Valor
cliente mínimo admitido Windows Vista
servidor mínimo admitido Windows Server 2008
de la plataforma de destino de Windows
encabezado de ktmw32.h
biblioteca de Ktmw32.lib
DLL de Ktmw32.dll

Consulte también

funciones del Administrador de transacciones de kernel

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort