Fungsi FindFirstFileNameTransactedW (winbase.h)
[Microsoft sangat menyarankan pengembang menggunakan cara alternatif untuk mencapai kebutuhan aplikasi Anda. Banyak skenario yang dikembangkan TxF dapat dicapai melalui teknik yang lebih sederhana dan lebih tersedia. Selain itu, TxF mungkin tidak tersedia di versi Microsoft Windows yang akan datang. Untuk informasi lebih lanjut, dan alternatif TxF, silakan lihat Alternatif untuk menggunakan Transactional NTFS.]
Membuat enumerasi semua tautan keras ke file yang ditentukan sebagai operasi yang ditransaksikan. Fungsi mengembalikan handel ke enumerasi yang dapat digunakan pada panggilan berikutnya ke fungsi FindNextFileNameW .
Sintaks
HANDLE FindFirstFileNameTransactedW(
[in] LPCWSTR lpFileName,
[in] DWORD dwFlags,
[in, out] LPDWORD StringLength,
[in, out] PWSTR LinkName,
[in, optional] HANDLE hTransaction
);
Parameter
[in] lpFileName
Nama file.
File harus berada di komputer lokal; jika tidak, fungsi gagal dan kode kesalahan terakhir diatur ke ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE (6805).
[in] dwFlags
Dipesan; tentukan nol (0).
[in, out] StringLength
Ukuran buffer yang diacu oleh parameter LinkName , dalam karakter. Jika panggilan ini gagal dan kesalahannya ERROR_MORE_DATA (234), nilai yang dikembalikan oleh parameter ini adalah ukuran yang ditujukan buffer oleh LinkName harus berisi semua data.
[in, out] LinkName
Penunjuk ke buffer untuk menyimpan nama tautan pertama yang ditemukan untuk lpFileName.
[in, optional] hTransaction
Handel ke transaksi. Handel ini dikembalikan oleh fungsi CreateTransaction .
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah handel pencarian yang dapat digunakan dengan fungsi FindNextFileNameW atau ditutup dengan fungsi FindClose .
Jika fungsi gagal, nilai yang dikembalikan adalah INVALID_HANDLE_VALUE (0xffffffff). Untuk
dapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .
Keterangan
Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.
| Teknologi | Didukung |
|---|---|
| Protokol Server Message Block (SMB) 3.0 | Tidak |
| SMB 3.0 Transparent Failover (TFO) | Tidak |
| SMB 3.0 dengan Scale-out File Shares (SO) | Tidak |
| Sistem File Volume Bersama Kluster (CsvFS) | Tidak |
| Sistem File Tangguh (ReFS) | Tidak |
SMB 3.0 tidak mendukung TxF.
Persyaratan
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winbase.h (termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |