Metode ITransferSource::Advise (shobjidl_core.h)

Artikel
08/26/2023

Menyiapkan koneksi saran 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 ITransferSource::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 ITransferSource::Advise sebelum memanggil metode lain dalam antarmuka ini untuk mengaktifkan sesi penasihat. Jika tidak diatur, handler harus menganggapnya sebagai indikasi bahwa tidak ada umpan balik yang tersedia dan untuk melakukan operasi "default" tanpa berkonsultasi dengan aplikasi panggilan.

Persyaratan


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