共用方式為

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
程式庫 WebServices.lib
Dll WebServices.dll