Fungsi FindFirstStreamTransactedW (winbase.h)

Artikel
03/13/2024

[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.]

Menghitung aliran pertama dalam file atau direktori yang ditentukan sebagai operasi yang ditransaksikan.

Sintaks

HANDLE FindFirstStreamTransactedW(
  [in]  LPCWSTR            lpFileName,
  [in]  STREAM_INFO_LEVELS InfoLevel,
  [out] LPVOID             lpFindStreamData,
        DWORD              dwFlags,
  [in]  HANDLE             hTransaction
);

Parameter

[in] lpFileName

Nama file yang sepenuhnya memenuhi syarat.

File harus berada di komputer lokal; jika tidak, fungsi gagal dan kode kesalahan terakhir diatur ke ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE (6805).

[in] InfoLevel

Tingkat informasi data yang dikembalikan. Parameter ini adalah salah satu nilai dalam jenis enumerasi STREAM_INFO_LEVELS .

Nilai	Makna
FindStreamInfoStandard 0	Data dikembalikan dalam struktur WIN32_FIND_STREAM_DATA .

[out] lpFindStreamData

Penunjuk ke buffer yang menerima data file. Format data ini tergantung pada nilai parameter InfoLevel .

dwFlags

Disiapkan untuk penggunaan masa mendatang. Parameter ini harus nol.

[in] hTransaction

Handel ke transaksi. Handel ini dikembalikan oleh fungsi CreateTransaction .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel pencarian yang dapat digunakan dalam panggilan berikutnya ke fungsi FindNextStreamW .

Jika fungsi gagal, nilai yang dikembalikan INVALID_HANDLE_VALUE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Semua file berisi aliran data default. Di NTFS, file juga dapat berisi satu atau beberapa aliran data bernama. Pada sistem file FAT, file tidak dapat memiliki lebih banyak aliran data default, dan oleh karena itu, fungsi ini tidak akan mengembalikan hasil yang valid ketika digunakan pada file sistem file FAT. Fungsi ini berfungsi pada semua sistem file yang mendukung tautan keras; jika tidak, fungsi mengembalikan ERROR_STATUS_NOT_IMPLEMENTED (6805).

Fungsi FindFirstStreamTransactedW membuka handel pencarian dan mengembalikan informasi tentang aliran pertama dalam file atau direktori yang ditentukan. Untuk file, ini selalu merupakan aliran data default, ::$DATA. Setelah handel pencarian dibuat, gunakan di fungsi FindNextStreamW untuk mencari aliran lain dalam file atau direktori yang ditentukan. Ketika handel pencarian tidak lagi diperlukan, handel harus ditutup menggunakan fungsi FindClose .

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 Berbagi File Peluasan Skala (SO)	Tidak
Sistem File Volume Bersama Kluster (CsvFS)	Tidak
Sistem File Tangguh (ReFS)	Tidak

SMB 3.0 tidak mendukung TxF.

Persyaratan

Persyaratan	Nilai
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