Funzione CreateResourceManager (ktmw32.h)

Articolo
11/20/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

Qualsiasi attributo facoltativo per il nuovo RM.

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

[in] TmHandle

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

[in, optional] Description

Descrizione per questo RM.

Valore restituito

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

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

L'elenco seguente identifica i possibili codici di errore:

Osservazioni

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

Un RM è un endpoint per le notifiche TM relative alle transazioni in cui è integrato 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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
server minimo supportato	Windows Server 2008
piattaforma di destinazione	Finestre
intestazione	ktmw32.h
libreria	Ktmw32.lib
dll	Ktmw32.dll

Vedere anche

funzioni di Gestione transazioni kernel

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort

Condividi tramite