ITransferSource：：Advise 方法 (shobjidl_core.h)

  • 發行項

設定有關檔案作業狀態通知的諮詢連線。

語法

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

參數

[in] psink

類型： ITransferAdviseSink*

通知介面 ITransferAdviseSink 的指標，可使用這個介面上的方法來更新呼叫的應用程式。

[out] pdwCookie

類型： DWORD*

可唯一識別此連線之傳回權杖的指標。 呼叫端應用程式稍後會使用此權杖來刪除連線，方法是將它傳遞至 ITransferSource：：Unadvise 方法。 如果連線未成功建立，則此值為零。

傳回值

類型： HRESULT

列出的任何 HRESULT 都表示失敗。

傳回碼 描述
S_OK
 介面已成功關聯。
E_UNEXPECTED
 處理常式只能處理一個接收介面。

備註

在此介面中呼叫任何其他方法之前，請先呼叫 ITransferSource：：Advisor ，以啟用諮詢會話。 如果未設定，處理常式應該將它視為沒有意見反應可用，而且不需要諮詢呼叫應用程式即可執行「預設」作業。

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)