Share via

Método ICancelMethodCalls::Cancel (objidl.h)

  • Artigo

Solicita que uma chamada de método seja cancelada.

Sintaxe

HRESULT Cancel(
  [in] ULONG ulSeconds
);

Parâmetros

[in] ulSeconds

O número de segundos a aguardar até que o servidor conclua a chamada de saída após o cliente solicitar o cancelamento.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 A solicitação de cancelamento foi feita.
RPC_S_CALL_CANCELED
 A chamada já foi cancelada.
CO_E_CANCEL_DISABLED
 O cancelamento de chamada não está habilitado no thread que está processando a chamada.
RPC_E_CALL_COMPLETE
 A chamada foi concluída durante o intervalo de tempo limite.

Comentários

O método Cancel emite apenas uma solicitação de cancelamento. Um valor retornado de S_OK não significa que a chamada foi cancelada, apenas que foi feita uma tentativa de cancelar a chamada. O comportamento do objeto cancel ao receber uma solicitação de cancelamento fica inteiramente a critério do implementador.

Se um método que retorna um HRESULT for cancelado, o valor retornado será RPC_S_CALL_CANCELED.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho objidl.h (inclua ObjIdl.h)

Confira também

ICancelMethodCalls