WsRegisterOperationForCancel, fonction (webservices.h)

Article
08/27/2023

Une opération de service peut utiliser cette fonction pour s’inscrire à une notification d’annulation. Il n’est valide d’appeler cette API que lorsque l’opération de service est en cours d’exécution. Le comportement de l’appel après la fin de l’opération de service n’est pas pris en charge.

Alors que cette API est appelée et que le runtime a déterminé que l’annulation de l’opération de service est nécessaire, il peut appeler le rappel pendant l’appel de cette API par l’application.

L’appelant doit donc supposer que le runtime peut appeler sur le rappel WS_OPERATION_CANCEL_CALLBACK dès que le WsRegisterOperationForCancel est appelé.

Syntaxe

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

Paramètres

[in] context

Contexte pour lequel la valeur de la propriété est obtenue.

[in] cancelCallback

Pointeur de fonction pour la fonction de notification d’annulation.

[in, optional] freestateCallback

Paramètre facultatif spécifiant le pointeur de fonction vers l’appel d’état libre.

[in, optional] userState

Paramètre facultatif spécifiant l’état spécifique de l’application qui peut être utilisé pour identifier les données d’appel.

[in, optional] error

Spécifie l’emplacement où les informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	webservices.h
Bibliothèque	WebServices.lib
DLL	WebServices.dll

Partager via