ITransferSource::Advise 方法 (shobjidl_core.h)
設定有關檔案作業狀態通知的諮詢連線。
語法
HRESULT Advise(
[in] ITransferAdviseSink *psink,
[out] DWORD *pdwCookie
);
參數
[in] psink
類型: ITransferAdviseSink*
通知介面 ITransferAdviseSink 的指標,可使用這個介面上的方法來更新呼叫的應用程式。
[out] pdwCookie
類型: DWORD*
可唯一識別此連線之傳回權杖的指標。 呼叫端應用程式稍後會使用此權杖來刪除連線,方法是將它傳遞至 ITransferSource::Unadvise 方法。 如果連線未成功建立,則此值為零。
傳回值
類型: HRESULT
列出的任何 HRESULT 都表示失敗。
傳回碼 | 描述 |
---|---|
|
介面已成功關聯。 |
|
處理常式只能處理一個接收介面。 |
備註
在此介面中呼叫任何其他方法之前,請先呼叫 ITransferSource::Advisor ,以啟用諮詢會話。 如果未設定,處理常式應該將它視為沒有意見反應可用,而且不需要諮詢呼叫應用程式即可執行「預設」作業。
規格需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shobjidl_core.h (包含 Shobjidl.h) |