ICancelMethodCalls::Cancel-Methode (objidlbase.h)

  • Artikel

Fordert an, dass ein Methodenaufruf abgebrochen wird.

Syntax

HRESULT Cancel(
  [in] ULONG ulSeconds
);

Parameter

[in] ulSeconds

Die Anzahl der Sekunden, die gewartet werden müssen, bis der Server den ausgehenden Anruf abgeschlossen hat, nachdem der Client die Abbruchanforderung anforderte.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Stornierungsanforderung wurde gestellt.
RPC_S_CALL_CANCELED
 Der Anruf wurde bereits abgebrochen.
CO_E_CANCEL_DISABLED
 Der Anrufabbruch ist für den Thread, der den Aufruf verarbeitet, nicht aktiviert.
RPC_E_CALL_COMPLETE
 Der Aufruf wurde während des Timeoutintervalls abgeschlossen.

Hinweise

Die Cancel-Methode gibt nur eine Abbruchanforderung aus. Ein Rückgabewert von S_OK bedeutet nicht, dass der Aufruf abgebrochen wurde, nur dass versucht wurde, den Aufruf abzubrechen. Das Verhalten des Abbruchobjekts beim Empfangen einer Abbruchanforderung liegt ganz im Ermessen des Implementierers.

Wenn eine Methode, die ein HRESULT zurückgibt, abgebrochen wird, wird der Rückgabewert RPC_S_CALL_CANCELED.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile objidlbase.h (include ObjIdl.h)

Weitere Informationen

ICancelMethodCalls