Funzione WsRegisterOperationForCancel (webservices.h)

Un'operazione del servizio può usare questa funzione per registrarsi per una notifica di annullamento. È valida solo per chiamare questa API quando l'operazione del servizio è in esecuzione. Il comportamento per chiamarlo dopo il completamento dell'operazione del servizio non è supportato.

Anche se questa API viene chiamata e il runtime ha determinato che l'annullamento dell'operazione del servizio è necessario, può chiamare il callback durante la chiamata a questa API dall'applicazione.

Il chiamante deve quindi presupporre che il runtime possa chiamare il callback WS_OPERATION_CANCEL_CALLBACK non appena viene chiamato WsRegisterOperationForCancel.

Sintassi

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

Parametri

[in] context

Contesto per il quale viene ottenuto il valore della proprietà.

[in] cancelCallback

Puntatore a funzione per la funzione di notifica di annullamento.

[in, optional] freestateCallback

Parametro facoltativo che specifica il puntatore di funzione alla chiamata di stato libero.

[in, optional] userState

Parametro facoltativo che specifica lo stato specifico dell'applicazione che può essere usato per identificare i dati delle chiamate.

[in, optional] error

Specifica dove archiviare informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll