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.
Valor | Significado |
---|---|
|
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 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
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows Vista |
Servidor mínimo compatible | Windows Server 2008 |
Plataforma de destino | Windows |
Encabezado | ktmw32.h |
Library | Ktmw32.lib |
Archivo DLL | Ktmw32.dll |