ICancelMethodCalls::Cancel-Methode (objidlbase.h)
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 |
|---|---|
|
Die Stornierungsanforderung wurde gestellt. |
|
Der Anruf wurde bereits abgebrochen. |
|
Der Anrufabbruch ist für den Thread, der den Aufruf verarbeitet, nicht aktiviert. |
|
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) |