ICancelMethodCalls::Cancel-Methode (objidl.h)
Fordert an, dass ein Methodenaufruf abgebrochen wird.
Syntax
HRESULT Cancel(
[in] ULONG ulSeconds
);
Parameter
[in] ulSeconds
Die Anzahl der Sekunden, die gewartet werden muss, bis der Server den ausgehenden Aufruf abgeschlossen hat, nachdem der Client den Abbruch anforderte.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Abbruchanforderung 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 Anruf abgebrochen wurde, nur dass versucht wurde, den Anruf abzubrechen. Das Verhalten des Cancel-Objekts beim Empfang einer Abbruchanforderung liegt vollständig 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 | objidl.h (include ObjIdl.h) |