Funzione CreateTransactionManager (ktmw32.h)

Crea un nuovo oggetto tm (Transaction Manager) e restituisce un handle con l'accesso specificato.

Sintassi

HANDLE CreateTransactionManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpTransactionAttributes,
  [in, optional] LPWSTR                LogFileName,
  [in, optional] ULONG                 CreateOptions,
  [in, optional] ULONG                 CommitStrength
);

Parametri

[in, optional] lpTransactionAttributes

La transazione SECURITY_ATTRIBUTES (ACL) per l'oggetto TM.

[in, optional] LogFileName

Nome del flusso di file di log. Se il flusso non esiste nel log, viene creato. Per creare una TM volatile, questo parametro deve essere NULL e CreateOptions deve specificare TRANSACTION_MANAGER_VOLATILE, questo gestore transazioni è considerato volatile.

[in, optional] CreateOptions

Tutti gli attributi facoltativi per il nuovo TM.

Valore	Significato
TRANSACTION_MANAGER_VOLATILE	Indica che la TM è volatile e non esegue il ripristino.

[in, optional] CommitStrength

Riservati; specificare zero.

Valore restituito

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

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

Immediatamente dopo aver chiamato questa funzione, è necessario chiamare RecoverTransactionManager.

Se il gestore delle transazioni è volatile, tutti i responsabili delle risorse devono essere volatili.

È necessario chiamare RecoverTransactionManager dopo aver creato una TM per consentire al TM di funzionare correttamente.

Requisiti

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

OpenTransactionManager

RecoveryTransactionManager

SECURITY_ATTRIBUTES