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