Função WsRegisterOperationForCancel (webservices.h)

Artigo
03/03/2024

Uma operação de serviço pode usar essa função para se registrar para uma notificação de cancelamento. Só é válido chamar essa API quando a operação de serviço estiver em execução. Não há suporte para o comportamento de chamá-lo após a conclusão da Operação de Serviço.

Embora essa API esteja sendo chamada e o runtime tenha determinado que o cancelamento da operação de serviço é necessário, ela pode chamar o retorno de chamada durante a chamada para essa API pelo aplicativo.

Portanto, o chamador deve assumir que o runtime pode chamar no retorno de chamada WS_OPERATION_CANCEL_CALLBACK assim que o WsRegisterOperationForCancel for chamado.

Sintaxe

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
);

Parâmetros

[in] context

O contexto para o qual o valor da propriedade está sendo obtido.

[in] cancelCallback

Ponteiro de função para a função de notificação de cancelamento.

[in, optional] freestateCallback

Um parâmetro opcional que especifica o ponteiro de função para a chamada de estado livre.

[in, optional] userState

Um parâmetro opcional que especifica o estado específico do aplicativo que pode ser usado para identificar dados de chamada.

[in, optional] error

Especifica onde informações adicionais de erro devem ser armazenadas se a função falhar.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	webservices.h
Biblioteca	WebServices.lib
DLL	WebServices.dll

Compartilhar via