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.

SMB 3.0 non supporta TxF.

Requisiti

Vedere anche

Funzioni di gestione file

FindClose

FindNextFileNameW

NTFS transazionale