IAgentCharacter::Interrupt

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

HRESULT Interrupt(
   long dwReqID,    // request ID to interrupt
   long * pdwReqID  // address of request ID
);

Interrompe l'animazione specificata (richiesta) di un altro carattere.

• Restituisce S_OK per indicare che l'operazione è riuscita. Quando la funzione restituisce, pdwReqID contiene l'ID della richiesta.

dwReqID

ID della richiesta da interrompere.

pdwReqID

Indirizzo di una variabile che riceve l'ID richiesta di interruzione .

Se si caricano più caratteri, è possibile usare questo metodo per sincronizzare l'animazione tra caratteri. Ad esempio, se un altro carattere si trova in un'animazione ciclo, questo metodo arresterà l'animazione di ciclo e avvia l'animazione successiva nella coda del carattere.

L'interruzione interrompe l'animazione esistente, ma non scarica la coda di animazione del carattere. Avvia l'animazione successiva nella coda del carattere. Per arrestare e scaricare la coda di un carattere, usare il metodo Stop .

Non è possibile usare questo metodo per avere un interruzione di carattere perché il server Microsoft Agent accoda il metodo Interrupt nella coda di animazione del carattere. È quindi possibile usare Interrupt solo per arrestare l'animazione di un altro carattere caricato.