Metodo ICancelMethodCalls::Cancel (objidlbase.h)

Richiede l'annullamento di una chiamata al metodo.

Sintassi

HRESULT Cancel(
  [in] ULONG ulSeconds
);

Parametri

[in] ulSeconds

Numero di secondi di attesa per il completamento della chiamata in uscita dal server dopo l'annullamento delle richieste del client.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Richiesta di annullamento effettuata.
RPC_S_CALL_CANCELED	La chiamata è già stata annullata.
CO_E_CANCEL_DISABLED	L'annullamento delle chiamate non è abilitato nel thread che sta elaborando la chiamata.
RPC_E_CALL_COMPLETE	La chiamata è stata completata durante l'intervallo di timeout.

Commenti

Il metodo Cancel invia solo una richiesta di annullamento. Un valore restituito di S_OK non significa che la chiamata è stata annullata, ma solo che è stato effettuato un tentativo di annullare la chiamata. Il comportamento dell'oggetto cancel alla ricezione di una richiesta di annullamento è interamente a discrezione dell'implementatore.

Se viene annullato un metodo che restituisce un valore HRESULT , il valore restituito verrà RPC_S_CALL_CANCELED.

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	objidlbase.h (include ObjIdl.h)

Vedi anche

ICancelMethodCalls