Funzione FindFirstFileNameTransactedW (winbase.h)

  • Articolo

[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

Vedere anche

Funzioni di gestione file

FindClose

FindNextFileNameW

NTFS transazionale