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)

另請參閱

IFileOperation

IFileOperation::Unadvise