Funzione FindFirstFileNameTransactedW (winbase.h)
[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.
Crea un'enumerazione di tutti i collegamenti reali al file specificato come operazione transazionata. La funzione restituisce un handle all'enumerazione che può essere utilizzata nelle chiamate successive alla funzione FindNextFileNameW .
Sintassi
HANDLE FindFirstFileNameTransactedW(
[in] LPCWSTR lpFileName,
[in] DWORD dwFlags,
[in, out] LPDWORD StringLength,
[in, out] PWSTR LinkName,
[in, optional] HANDLE hTransaction
);
Parametri
[in] lpFileName
Nome del file.
Il file deve risiedere nel computer locale; in caso contrario, la funzione ha esito negativo e l'ultimo codice di errore è impostato su ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE (6805).
[in] dwFlags
Riservati; specificare zero (0).
[in, out] StringLength
Dimensioni del buffer a cui punta il parametro LinkName , in caratteri. Se la chiamata non riesce e l'errore è ERROR_MORE_DATA (234), il valore restituito da questo parametro è la dimensione a cui deve essere puntato il buffer da LinkName per contenere tutti i dati.
[in, out] LinkName
Puntatore a un buffer per archiviare il primo nome di collegamento trovato per lpFileName.
[in, optional] hTransaction
Handle per la transazione. Questo handle viene restituito dalla funzione CreateTransaction .
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle di ricerca che può essere usato con la funzione FindNextFileNameW o chiuso con la funzione FindClose .
Se la funzione ha esito negativo, il valore restituito viene INVALID_HANDLE_VALUE (0xffffffff). Per
ottenere informazioni estese sull'errore, chiamare la funzione GetLastError .
Commenti
In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.
| Tecnologia | Supportato |
|---|---|
| Protocollo SMB (Server Message Block) 3.0 | No |
| Failover trasparente SMB 3.0 (TFO) | No |
| SMB 3.0 con condivisioni file di scalabilità orizzontale (SO) | No |
| File system del volume condiviso cluster (CsvFS) | No |
| Resilient File System (ReFS) | No |
SMB 3.0 non supporta TxF.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |