WsRegisterOperationForCancel-Funktion (webservices.h)
Ein Dienstvorgang kann diese Funktion verwenden, um sich für eine Abbruchbenachrichtigung zu registrieren. Es ist nur gültig, diese API aufzurufen, wenn der Dienstvorgang ausgeführt wird. Das Verhalten für den Aufruf nach Abschluss des Dienstvorgangs wird nicht unterstützt.
Während diese API aufgerufen wird und die Runtime ermittelt hat, dass der Abbruch des Dienstvorgangs erforderlich ist, kann sie den Rückruf während des Aufrufs dieser API durch die Anwendung aufrufen.
Der Aufrufer sollte daher davon ausgehen, dass die Laufzeit für den Rückruf WS_OPERATION_CANCEL_CALLBACK aufrufen kann, sobald WsRegisterOperationForCancel aufgerufen wird.
Syntax
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
);
Parameter
[in] context
Der Kontext, für den der Eigenschaftswert abgerufen wird.
[in] cancelCallback
Funktionszeiger für die Funktion "Benachrichtigung abbrechen".
[in, optional] freestateCallback
Ein optionaler Parameter, der den Funktionszeiger auf den Aufruf des freien Zustands angibt.
[in, optional] userState
Ein optionaler Parameter, der den anwendungsspezifischen Zustand angibt, der zum Identifizieren von Aufrufdaten verwendet werden kann.
[in, optional] error
Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.
Rückgabewert
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | webservices.h |
Bibliothek | WebServices.lib |
DLL | WebServices.dll |