Funzione GetFileAttributesTransactedW (winbase.h)

Articolo
11/20/2024

[Microsoft consiglia vivamente agli sviluppatori di usare mezzi alternativi per soddisfare le esigenze dell'applicazione. Molti scenari per cui è stato sviluppato TxF possono essere ottenuti tramite tecniche più semplici e più facilmente disponibili. Inoltre, TxF potrebbe non essere disponibile nelle versioni future di Microsoft Windows. Per altre informazioni e alternative a TxF, vedere Alternative all'uso di NTFS transazionale.]

Recupera gli attributi del file system per un file o una directory specificata come operazione transazionata.

Sintassi

BOOL GetFileAttributesTransactedW(
  [in]  LPCWSTR                lpFileName,
  [in]  GET_FILEEX_INFO_LEVELS fInfoLevelId,
  [out] LPVOID                 lpFileInformation,
  [in]  HANDLE                 hTransaction
);

Parametri

[in] lpFileName

Nome del file o della directory.

Il file o la directory devono risiedere nel computer locale; in caso contrario, la funzione ha esito negativo e l'ultimo codice di errore è impostato su ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE.

Per impostazione predefinita, il nome è limitato a MAX_PATH caratteri. Per estendere questo limite a 32.767 caratteri wide, anteporre "\\?\" al percorso. Per altre informazioni, vedere denominazione di file, percorsi e spazi dei nomi.

Mancia

A partire da Windows 10, versione 1607, è possibile acconsentire esplicitamente alla rimozione della limitazione MAX_PATH senza anteporre "\\?\". Per informazioni dettagliate, vedere la sezione "Limitazione massima della lunghezza del percorso" di nomi, percorsi e spazi dei nomi.

[in] fInfoLevelId

Livello di informazioni sugli attributi da recuperare.

Questo parametro può essere il valore seguente dell'enumerazione GET_FILEEX_INFO_LEVELS.

Valore	Significato
GetFileExInfoStandard	Il parametro lpFileInformation è una struttura WIN32_FILE_ATTRIBUTE_DATA.

[out] lpFileInformation

Puntatore a un buffer che riceve le informazioni sull'attributo.

Il tipo di informazioni sull'attributo archiviato in questo buffer è determinato dal valore di fInfoLevelId. Se il parametro fInfoLevelId è GetFileExInfoStandard, questo parametro punta a una struttura WIN32_FILE_ATTRIBUTE_DATA

[in] hTransaction

Handle per la transazione. Questo handle viene restituito dalla funzione CreateTransaction.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

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

Osservazioni

Quando getFileAttributesTransacted viene chiamato in una directory montata, restituisce gli attributi della directory, non quelli della directory radice nel volume associato alla directory montata. Per ottenere gli attributi di file del volume associato, chiamare GetVolumeNameForVolumeMountPoint per ottenere il nome del volume associato. Usare quindi il nome risultante in una chiamata a GetFileAttributesTransacted. I risultati sono gli attributi della directory radice nel volume associato.

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia	Sostenuto
Protocollo SMB (Server Message Block) 3.0	No
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	No
Cluster Shared Volume File System (CsvFS)	No
Resilient File System (ReFS)	No

SMB 3.0 non supporta TxF.

Collegamenti simbolici: Se il percorso punta a un collegamento simbolico, la funzione restituisce gli attributi per il collegamento simbolico.

operazioni transazionate

Se un file è aperto per la modifica in una transazione, nessun altro thread può aprire il file per la modifica finché non viene eseguito il commit della transazione. Viceversa, se un file è aperto per la modifica all'esterno di una transazione, nessun thread transazionale può aprire il file per la modifica fino alla chiusura dell'handle non transazionale. Se un thread non transazionato ha un handle aperto per modificare un file, una chiamata a GetFileAttributesTransacted per tale file avrà esito negativo con un errore ERROR_TRANSACTIONAL_CONFLICT.

Nota

L'intestazione winbase.h definisce GetFileAttributesTransacted come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winbase.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll