IFileOperation::Advise 方法 (shobjidl_core.h)
可讓處理程式提供所有作業的狀態和錯誤資訊。
語法
HRESULT Advise(
[in] IFileOperationProgressSink *pfops,
[out] DWORD *pdwCookie
);
參數
[in] pfops
類型: IFileOperationProgressSink*
IFileOperationProgressSink 物件的指標,用於進度狀態和錯誤通知。
[out] pdwCookie
類型: DWORD*
當這個方法傳回時,此參數會指向可唯一識別此聯機的傳回令牌。 呼叫端應用程式稍後會使用此令牌來刪除連線,方法是將它傳遞給 IFileOperation::Unadvise。 如果對 建議 的呼叫失敗,這個值就沒有意義。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
有數個個別方法能夠宣告自己的進度接收,這在此集合中是多餘的。 當您只想要提供特定作業的進度和錯誤資訊時,就會使用它們。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shobjidl_core.h (包含 Shobjidl.h) |