IIOCancelInformation::SetCancelInformation 方法 (shobjidl_core.h)

设置当用户从进度 UI 中选择 “取消” 时发布的信息。 允许main对象告知进度对话线程有关进程线程的信息,以便进度对话可以在用户单击“取消”时向进程线程发送消息 ID。

语法

HRESULT SetCancelInformation(
  [in] DWORD dwThreadID,
  [in] UINT  uMsgCancel
);

参数

[in] dwThreadID

类型:DWORD

要取消的进程线程的 ID。

[in] uMsgCancel

类型: UINT

要发布到线程的取消消息。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

当用户从进度 UI 中选择 “取消” 时, dwThreadID 将取消任何挂起的或未来的输入/输出 (I/O) 请求。 此外,从进度对话框收到的 uMsgCancel 消息将发布到线程,以告知它退出等待状态(如果异步 I/O 挂起)。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
DLL Shell32.dll