Metode ITransferDestination::Advise (shobjidl_core.h)

Artikel
03/02/2024

Menyiapkan koneksi penasihat untuk pemberitahuan tentang status operasi file.

Sintaks

HRESULT Advise(
  [in]  ITransferAdviseSink *psink,
  [out] DWORD               *pdwCookie
);

Parameter

[in] psink

Jenis: ITransferAdviseSink*

Penunjuk ke antarmuka pemberitahuan ITransferAdviseSink untuk memperbarui aplikasi panggilan menggunakan metode pada antarmuka ini.

[out] pdwCookie

Jenis: DWORD*

Penunjuk ke token yang dikembalikan yang secara unik mengidentifikasi koneksi ini. Aplikasi panggilan menggunakan token ini nanti untuk menghapus koneksi dengan meneruskannya ke metode ITransferDestination::Unadvise . Jika koneksi tidak berhasil dibuat, nilai ini adalah nol.

Mengembalikan nilai

Jenis: HRESULT

Setiap HRESULT selain yang tercantum menunjukkan kegagalan.

Menampilkan kode	Deskripsi
S_OK	Antarmuka berhasil dikaitkan.
E_UNEXPECTED	Handler hanya dapat menangani satu antarmuka sink.

Keterangan

Panggil ITransferDestination::Advise sebelum memanggil metode ITransferDestination lainnya sehingga handler dapat memanggil balik untuk kesalahan apa pun yang mungkin terjadi. Jika tidak diatur, handler harus menganggapnya sebagai indikasi bahwa tidak ada umpan balik yang tersedia dan melakukan operasi "default".

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)

Bagikan melalui