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