Funzione CoEnableCallCancellation (combaseapi.h)
Abilita l'annullamento delle chiamate sincrone nel thread chiamante.
Sintassi
HRESULT CoEnableCallCancellation(
[in, optional] LPVOID pReserved
);
Parametri
[in, optional] pReserved
Questo parametro è riservato e deve essere NULL.
Valore restituito
Questa funzione può restituire i valori restituiti standard S_OK, E_FAIL, E_INVALIDARG e E_OUTOFMEMORY.
Commenti
Quando l'annullamento delle chiamate è abilitato in un thread, le chiamate sincrone sincrone da quel thread a oggetti nello stesso computer possono subire gravi riduzione delle prestazioni. Per impostazione predefinita, le chiamate sincrone non possono essere annullate, anche se è disponibile un oggetto cancel. Per abilitare l'annullamento delle chiamate, è necessario chiamare prima CoEnableCallCancellation .
A meno che non si voglia abilitare l'annullamento delle chiamate in un thread in ogni momento, è necessario associare le chiamate a CoEnableCallCancellation con le chiamate a CoDisableCallCancellation. L'annullamento delle chiamate è disabilitato solo se coDisableCallCancellation è stato chiamato una volta per ogni volta che CoEnableCallCancellation è stato chiamato correttamente.
Una chiamata sarà annullabile o meno a seconda dello stato del thread al momento dell'esecuzione della chiamata. Successivamente l'abilitazione o la disabilitazione dell'annullamento delle chiamate non ha alcun effetto sulle chiamate in sospeso nel thread.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | combaseapi.h (include Objbase.h) |
| Libreria | Ole32.lib |
| DLL | Ole32.dll |