WsRegisterOperationForCancel-Funktion (webservices.h)

Artikel
03/03/2024

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

Freigeben über