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 |