Classe CAtlTransactionManager
La classe CAtlTransactionManager fornisce un wrapper alle funzioni KTM (Kernel Transaction Manager).
Importante
Questa classe e i relativi membri non possono essere usati nelle applicazioni eseguite in Windows Runtime.
Sintassi
class CAtlTransactionManager;
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| ~CAtlTransactionManager | Distruttore CAtlTransactionManager. |
| CAtlTransactionManager | Costruttore CAtlTransactionManager. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| Chiudi | Chiude un handle di transazione. |
| Eseguire il commit | Richiede il commit della transazione. |
| Crea | Crea l'handle di transazione. |
| CreateFile | Crea o apre un file, un flusso di file o una directory come operazione transazionata. |
| DeleteFile | Elimina un file esistente come operazione transazionata. |
| Findfirstfile | Cerca in una directory un file o una sottodirectory come operazione transazionata. |
| GetFileAttributes | Recupera gli attributi del file system per un file o una directory specificata come operazione transazionata. |
| GetFileAttributesEx | Recupera gli attributi del file system per un file o una directory specificata come operazione transazionata. |
| GetHandle | Restituisce l'handle di transazione. |
| IsFallback | Determina se le chiamate di fallback sono abilitate. |
| MoveFile | Sposta un file esistente o una directory, inclusi i relativi elementi figlio, come operazione transazionata. |
| RegCreateKeyEx | Crea la chiave del Registro di sistema specificata e la associa a una transazione. Se la chiave esiste già, la funzione la apre. |
| RegDeleteKey | Elimina una sottochiave e i relativi valori dalla vista specifica della piattaforma specificata del Registro di sistema come operazione transazionata. |
| Regopenkeyex | Apre la chiave del Registro di sistema specificata e la associa a una transazione. |
| Rollback | Richiede il rollback della transazione. |
| SetFileAttributes | Imposta gli attributi per un file o una directory come operazione transazionata. |
Membri dati protetti
| Nome | Descrizione |
|---|---|
| m_bFallback | TRUE se il fallback è supportato; FAL edizione Standard in caso contrario. |
| m_hTransaction | Handle di transazione. |
Osservazioni:
Gerarchia di ereditarietà
Requisiti
Intestazione: atltransactionmanager.h
~CAtlTransactionManager
Distruttore CAtlTransactionManager.
virtual ~CAtlTransactionManager();
Osservazioni:
Nell'elaborazione normale, viene eseguito automaticamente il commit e la chiusura della transazione. Se il distruttore viene chiamato durante la rimozione di un'eccezione, viene eseguito il rollback e la chiusura della transazione.
CAtlTransactionManager
Costruttore CAtlTransactionManager.
CAtlTransactionManager(BOOL bFallback = TRUE, BOOL bAutoCreateTransaction = TRUE);
Parametri
bFallback
TRUE indica il fallback del supporto. Se la funzione transazionata ha esito negativo, la classe chiama automaticamente la funzione "non transazionata". FAL edizione Standard indica nessuna chiamata di fallback.
bAutoCreateTransaction
TRUE indica che il gestore delle transazioni viene creato automaticamente nel costruttore. FAL edizione Standard indica che non lo è.
Osservazioni:
Chiusura
Chiude l'handle della transazione.
inline BOOL Close();
Valore restituito
TRUE se l'operazione riesce; in caso contrario, FALSE.
Osservazioni:
Questo wrapper chiama la CloseHandle funzione . Il metodo viene chiamato automaticamente nel distruttore.
Commit
Richiede il commit della transazione.
inline BOOL Commit();
Valore restituito
TRUE se l'operazione riesce; in caso contrario, FALSE.
Osservazioni:
Questo wrapper chiama la CommitTransaction funzione . Il metodo viene chiamato automaticamente nel distruttore.
Creazione
Crea l'handle di transazione.
inline BOOL Create();
Valore restituito
TRUE se l'operazione riesce; in caso contrario, FALSE.
Osservazioni:
Questo wrapper chiama la CreateTransaction funzione . Verificare la presenza di
CreateFile
Crea o apre un file, un flusso di file o una directory come operazione transazionata.
inline HANDLE CreateFile(
LPCTSTR lpFileName,
DWORD dwDesiredAccess,
DWORD dwShareMode,
LPSECURITY_ATTRIBUTES lpSecurityAttributes,
DWORD dwCreationDisposition,
DWORD dwFlagsAndAttributes,
HANDLE hTemplateFile);
Parametri
lpFileName
Nome di un oggetto da creare o aprire.
dwDesiredAccess
Accesso all'oggetto, che può essere riepilogato come lettura, scrittura, entrambe o nessuna delle due (zero). I valori usati più comunemente sono GENERIC_READ, GENERIC_WRITEo entrambi: GENERIC_READ | GENERIC_WRITE.
dwShareMode
La modalità di condivisione di un oggetto, che può essere letta, scritta, entrambe, eliminate, tutte queste o nessuna: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.
lpSecurityAttributes
Puntatore a una struttura di edizione StandardCURITY_ATTRIBUTES che contiene un descrittore di sicurezza facoltativo e determina anche se l'handle restituito può essere ereditato dai processi figlio. Il parametro può essere NULL.
dwCreationDisposition
Azione da intraprendere sui file esistenti e non esistenti. Questo parametro deve essere uno dei valori seguenti, che non può essere combinato: CREATE_ALWAYS, CREATE_NEW, OPEN_ALWAYS, OPEN_EXISTING o TRUNCATE_EXISTING.
dwFlagsAndAttributes
Attributi e flag del file. Questo parametro può includere qualsiasi combinazione degli attributi di file disponibili (FILE_ATTRIBUTE_*). Tutti gli altri attributi di file sostituiscono FILE_ATTRIBUTE_NORMAL. Questo parametro può contenere anche combinazioni di flag (FILE_FLAG_*) per il controllo del comportamento di buffering, delle modalità di accesso e di altri flag speciali. Questi valori vengono combinati con qualsiasi valore FILE_ATTRIBUTE_*.
hTemplateFile
Handle valido per un file modello con il diritto di accesso GENERIC_READ. Il file modello fornisce attributi di file e attributi estesi per il file in fase di creazione. Questo parametro può essere NULL.
Valore restituito
Restituisce un handle che può essere utilizzato per accedere all'oggetto .
Osservazioni:
Questo wrapper chiama la CreateFileTransacted funzione .
DeleteFile
Elimina un file esistente come operazione transazionata.
inline BOOL DeleteFile(LPCTSTR lpFileName);
Parametri
lpFileName
Nome del file da eliminare.
Osservazioni:
Questo wrapper chiama la DeleteFileTransacted funzione .
Findfirstfile
Cerca in una directory un file o una sottodirectory come operazione transazionata.
inline HANDLE FindFirstFile(
LPCTSTR lpFileName,
WIN32_FIND_DATA* pNextInfo);
Parametri
lpFileName
La directory o il percorso e il nome del file da cercare. Questo parametro può includere caratteri jolly, ad esempio un asterisco (*) o un punto interrogativo ().
pNextInfo
Puntatore alla struttura WIN32_FIND_DATA che riceve informazioni su un file trovato o una sottodirectory.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle di ricerca usato in una chiamata successiva a FindNextFile o FindClose. Se la funzione ha esito negativo o non riesce a individuare i file dalla stringa di ricerca nel parametro lpFileName , il valore restituito viene INVALID_HANDLE_VALUE.
Osservazioni:
Questo wrapper chiama la FindFirstFileTransacted funzione .
GetFileAttributes
Recupera gli attributi del file system per un file o una directory specificata come operazione transazionata.
inline DWORD GetFileAttributes(LPCTSTR lpFileName);
Parametri
lpFileName
Nome del file o della directory.
Osservazioni:
Questo wrapper chiama la GetFileAttributesTransacted funzione .
GetFileAttributesEx
Recupera gli attributi del file system per un file o una directory specificata come operazione transazionata.
inline BOOL GetFileAttributesEx(
LPCTSTR lpFileName,
GET_FILEEX_INFO_LEVELS fInfoLevelId,
LPVOID lpFileInformation);
Parametri
lpFileName
Nome del file o della directory.
fInfoLevelId
Livello di informazioni sugli attributi da recuperare.
lpFileInformation
Puntatore a un buffer che riceve le informazioni sull'attributo. Il tipo di informazioni sugli attributi archiviate in questo buffer è determinato dal valore di fInfoLevelId. Se il parametro fInfoLevelId è GetFileExInfoStandard, questo parametro punta a una struttura WIN32_FILE_ATTRIBUTE_DATA.
Osservazioni:
Questo wrapper chiama la GetFileAttributesTransacted funzione .
GetHandle
Restituisce l'handle di transazione.
HANDLE GetHandle() const;
Valore restituito
Restituisce l'handle di transazione per una classe. Restituisce NULL se l'oggetto CAtlTransactionManager non è associato a un handle.
Osservazioni:
IsFallback
Determina se le chiamate di fallback sono abilitate.
BOOL IsFallback() const;
Valore restituito
Restituisce TRUE è la classe che supporta le chiamate di fallback. FAL edizione Standard in caso contrario.
Osservazioni:
m_bFallback
TRUE se il fallback è supportato; FAL edizione Standard in caso contrario.
BOOL m_bFallback;
Osservazioni:
m_hTransaction
Handle di transazione.
HANDLE m_hTransaction;
Osservazioni:
MoveFile
Sposta un file esistente o una directory, inclusi i relativi elementi figlio, come operazione transazionata.
inline BOOL MoveFile(LPCTSTR lpOldFileName, LPCTSTR lpNewFileName);
Parametri
lpOldFileName
Nome corrente del file o della directory esistente nel computer locale.
lpNewFileName
Nuovo nome per il file o la directory. Questo nome non deve esistere già. Un nuovo file può trovarsi in un file system o in un'unità diversa. Una nuova directory deve trovarsi nella stessa unità.
Osservazioni:
Questo wrapper chiama la MoveFileTransacted funzione .
RegCreateKeyEx
Crea la chiave del Registro di sistema specificata e la associa a una transazione. Se la chiave esiste già, la funzione la apre.
inline LSTATUS RegCreateKeyEx(
HKEY hKey,
LPCTSTR lpSubKey,
DWORD dwReserved,
LPTSTR lpClass,
DWORD dwOptions,
REGSAM samDesired,
CONST LPSECURITY_ATTRIBUTES lpSecurityAttributes,
PHKEY phkResult,
LPDWORD lpdwDisposition);
Parametri
Hkey
Handle per una chiave del Registro di sistema aperta.
lpSubKey
Nome di una sottochiave aperta o creata da questa funzione.
dwReserved
Questo parametro è riservato e deve essere zero.
lpClass
Classe definita dall'utente di questa chiave. Questo parametro può essere ignorato. Questo parametro può essere NULL.
dwOptions
Questo parametro può essere uno dei valori seguenti: REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE o REG_OPTION_VOLATILE.
samDesired
Maschera che specifica i diritti di accesso per la chiave.
lpSecurityAttributes
Puntatore a una struttura SECURITY_ATTRIBUTES che determina se l'handle restituito può essere ereditato dai processi figlio. Se lpSecurityAttributes è NULL, l'handle non può essere ereditato.
phkResult
Puntatore a una variabile che riceve un handle per la chiave aperta o creata. Se la chiave non è una delle chiavi del Registro di sistema predefinite, chiamare la RegCloseKey funzione al termine dell'uso dell'handle.
lpdwDisposition
Puntatore a una variabile che riceve uno dei valori di eliminazione seguenti: REG_CREATED_NEW_KEY o REG_OPENED_EXISTING_KEY.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS. Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero definito in Winerror.h.
Osservazioni:
Questo wrapper chiama la RegCreateKeyTransacted funzione .
RegDeleteKey
Elimina una sottochiave e i relativi valori dalla vista specifica della piattaforma specificata del Registro di sistema come operazione transazionata.
inline LSTATUS RegDeleteKeyEx(HKEY hKey, LPCTSTR lpSubKey);
Parametri
Hkey
Handle per una chiave del Registro di sistema aperta.
lpSubKey
Nome della chiave da eliminare.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS. Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero definito in Winerror.h.
Osservazioni:
Questo wrapper chiama la RegDeleteKeyTransacted funzione .
Regopenkeyex
Apre la chiave del Registro di sistema specificata e la associa a una transazione.
inline LSTATUS RegOpenKeyEx(
HKEY hKey,
LPCTSTR lpSubKey,
DWORD ulOptions,
REGSAM samDesired,
PHKEY phkResult);
Parametri
Hkey
Handle per una chiave del Registro di sistema aperta.
lpSubKey
Nome della sottochiave del Registro di sistema da aprire.
ulOptions
Questo parametro è riservato e deve essere zero.
samDesired
Maschera che specifica i diritti di accesso per la chiave.
phkResult
Puntatore a una variabile che riceve un handle per la chiave aperta o creata. Se la chiave non è una delle chiavi del Registro di sistema predefinite, chiamare la RegCloseKey funzione al termine dell'uso dell'handle.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS. Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero definito in Winerror.h
Osservazioni:
Questo wrapper chiama la RegOpenKeyTransacted funzione .
Rollback
Richiede il rollback della transazione.
inline BOOL Rollback();
Valore restituito
TRUE se l'operazione riesce; in caso contrario, FALSE.
Osservazioni:
Questo wrapper chiama la RollbackTransaction funzione .
SetFileAttributes
Imposta gli attributi per un file o una directory come operazione transazionata.
inline BOOL SetFileAttributes(LPCTSTR lpFileName, DWORD dwAttributes);
Parametri
lpFileName
Nome del file o della directory.
dwAttributes
Attributi di file da impostare per il file. Per altre informazioni, vedere SetFileAttributesTransacted.
Osservazioni:
Questo wrapper chiama la SetFileAttributesTransacted funzione .
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per