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 |
---|---|
|
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 |