WsRegisterOperationForCancel, fonction (webservices.h)
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 |