Funzione CreateResourceManager (ktmw32.h)

Articolo
03/05/2024

Crea un nuovo oggetto resource manager (RM) e associa l'RM a un gestore transazioni (TM).

Sintassi

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

Parametri

[in, optional] lpResourceManagerAttributes

Puntatore a una struttura SECURITY_ATTRIBUTES che contiene gli attributi di sicurezza per resource manager. Specificare NULL per ottenere gli attributi predefiniti.

[in] ResourceManagerId

Puntatore al GUID di Resource Manager. Questo parametro è obbligatorio e non deve essere NULL.

[in, optional] CreateOptions

Eventuali attributi facoltativi per il nuovo RM.

Valore	Significato
RESOURCE_MANAGER_VOLATILE	Indica che rm è volatile e non esegue il ripristino.

[in] TmHandle

Handle per la tm che gestirà le transazioni per questo RM.

[in, optional] Description

Descrizione di questo RM.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per RM.

Se la funzione ha esito negativo, il valore restituito è INVALID_HANDLE_VALUE. Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .

L'elenco seguente identifica i possibili codici di errore:

Commenti

Subito dopo aver chiamato questa funzione, è necessario chiamare RecoverResourceManager.

Un RM è un endpoint per le notifiche TM relative alle transazioni in cui è incluso l'RM.

Le macchine virtuali sono in genere persistenti, ovvero dopo un errore di sistema, devono essere riaperte per eseguire determinate operazioni. È possibile creare macchine virtuali volatili o temporanee chiamando la funzione CreateResourceManager e specificando RESOURCE_MANAGER_VOLATILE. Le macchine virtuali volatili non eseguono operazioni di ripristino, ma richiedono notifiche su una transazione.

È possibile creare un RM volatile in una tm durevole, ma non è possibile creare un RM durevole in una tm volatile.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	ktmw32.h
Libreria	Ktmw32.lib
DLL	Ktmw32.dll

Vedi anche

Funzioni di Gestione transazioni kernel

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort

Condividi tramite