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
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 viene considerato volatile.
[in, optional] CreateOptions
Qualsiasi attributo facoltativo per il nuovo tm.
| Valore | Significato |
|---|---|
|
Indica che il tm è volatile e non esegue il ripristino. |
[in, optional] CommitStrength
Riservato; specificare zero.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle per la gestione transazioni.
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 RecoverTransactionManager.
Se il gestore delle transazioni è volatile, anche tutti i gestori di risorse devono essere volatili.
È necessario chiamare RecoverTransactionManager dopo la creazione di una tm affinché il tm funzioni correttamente.
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 |