Condividi tramite


Funzione CreateResourceManager (ktmw32.h)

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