IFileOperation::Metode saran (shobjidl_core.h)
Memungkinkan handler untuk memberikan informasi status dan kesalahan untuk semua operasi.
Sintaks
HRESULT Advise(
[in] IFileOperationProgressSink *pfops,
[out] DWORD *pdwCookie
);
Parameter
[in] pfops
Jenis: IFileOperationProgressSink*
Penunjuk ke objek IFileOperationProgressSink yang akan digunakan untuk status kemajuan dan pemberitahuan kesalahan.
[out] pdwCookie
Jenis: DWORD*
Ketika metode ini kembali, parameter ini menunjuk ke token yang dikembalikan yang secara unik mengidentifikasi koneksi ini. Aplikasi panggilan menggunakan token ini nanti untuk menghapus koneksi dengan meneruskannya ke IFileOperation::Unadvise. Jika panggilan ke Advise gagal, nilai ini tidak ada artinya.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Beberapa metode individu memiliki kemampuan untuk mendeklarasikan sink kemajuan mereka sendiri, yang berlebihan untuk satu set di sini. Mereka digunakan ketika Anda hanya ingin diberi kemajuan dan informasi kesalahan untuk operasi tertentu.
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 | shobjidl_core.h (termasuk Shobjidl.h) |