WsRegisterOperationForCancel 函数 (webservices.h)

服务操作可以使用此函数注册取消通知。 仅在执行服务操作时调用此 API 才有效。 不支持在完成服务操作后调用它的行为。

虽然正在调用此 API，并且运行时已确定必须取消服务操作，但它可以在应用程序调用此 API 期间调用回调。

因此，调用方应假定运行时可以在调用 WsRegisterOperationForCancel 后立即对回调 WS_OPERATION_CANCEL_CALLBACK 调用 。

语法

HRESULT WsRegisterOperationForCancel(
  [in]           const WS_OPERATION_CONTEXT       *context,
  [in]           WS_OPERATION_CANCEL_CALLBACK     cancelCallback,
  [in, optional] WS_OPERATION_FREE_STATE_CALLBACK freestateCallback,
  [in, optional] void                             *userState,
  [in, optional] WS_ERROR                         *error
);

参数

[in] context

要为其获取属性值的上下文。

[in] cancelCallback

用于取消通知函数的函数指针。

[in, optional] freestateCallback

一个可选参数，指定指向自由状态调用的函数指针。

[in, optional] userState

一个可选参数，指定可用于标识调用数据的应用程序特定状态。

[in, optional] error

指定函数失败时应存储其他错误信息的位置。

返回值

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	webservices.h
Library	WebServices.lib
DLL	WebServices.dll