CoEnableCallCancellation-Funktion (combaseapi.h)
Aktiviert das Abbrechen synchroner Aufrufe für den aufrufenden Thread.
Syntax
HRESULT CoEnableCallCancellation(
[in, optional] LPVOID pReserved
);
Parameter
[in, optional] pReserved
Dieser Parameter ist reserviert und muss NULL sein.
Rückgabewert
Diese Funktion kann die Standardrückgabewerte S_OK, E_FAIL, E_INVALIDARG und E_OUTOFMEMORY zurückgeben.
Hinweise
Wenn der Abbruch des Aufrufs in einem Thread aktiviert ist, können gemarderte synchrone Aufrufe von diesem Thread an Objekte auf demselben Computer schwerwiegende Leistungseinbußen erleiden. Synchrone Aufrufe können standardmäßig nicht abgebrochen werden, auch wenn ein Abbruchobjekt verfügbar ist. Um den Anrufabbruch zu aktivieren, müssen Sie zuerst CoEnableCallCancellation aufrufen.
Sofern Sie die Anrufabbruch nicht jederzeit für einen Thread aktivieren möchten, sollten Sie Aufrufe von CoEnableCallCancellation mit Aufrufen von CoDisableCallCancellation koppeln. Der Abbruch von Anrufen ist nur deaktiviert, wenn CoDisableCallCancellation für jeden erfolgreichen Aufruf von CoEnableCallCancellation einmal aufgerufen wurde.
Ein Aufruf ist abbruchfähig oder nicht abhängig vom Zustand des Threads zum Zeitpunkt des Aufrufs. Das anschließende Aktivieren oder Deaktivieren der Anrufabbruch hat keine Auswirkungen auf Aufrufe, die im Thread ausstehen.
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 | combaseapi.h (include Objbase.h) |
| Bibliothek | Ole32.lib |
| DLL | Ole32.dll |