Fungsi FindFirstFileNameTransactedW (winbase.h)

Artikel
08/27/2023

[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

Lihat juga

Fungsi Manajemen File

FindClose

FindNextFileNameW

NTFS Transaksi

Share via