Функция WsRegisterOperationForCancel (webservices.h)

Статья
03/03/2024

Операция службы может использовать эту функцию для регистрации уведомления об отмене. Этот API можно вызывать только при выполнении операции службы. Поведение для вызова после завершения операции службы не поддерживается.

Хотя этот API вызывается и среда выполнения определила, что отмена операции службы является необходимой, она может вызвать обратный вызов во время вызова этого API приложением.

Поэтому вызывающий объект должен предполагать, что среда выполнения может вызывать WS_OPERATION_CANCEL_CALLBACK обратного вызова сразу после вызова WsRegisterOperationForCancel.

Синтаксис

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
Header	webservices.h
Библиотека	WebServices.lib
DLL	WebServices.dll

Share via