IActiveScript::InterruptScriptThreadIActiveScript::InterruptScriptThread

Interrompt l’exécution d’un thread en cours d’exécution de script (un récepteur d’événements, une exécution immédiate ou un appel de macro).Interrupts the execution of a running script thread (an event sink, an immediate execution, or a macro invocation). Cette méthode peut être utilisée pour mettre fin à un script qui est bloqué (par exemple, dans une boucle infinie).This method can be used to terminate a script that is stuck (for example, in an infinite loop). Il peut être appelé à partir de threads de l’autre base sans résultant dans une légende de l’autre base d’héberger des objets ou à la IActiveScriptSite (méthode).It can be called from non-base threads without resulting in a non-base callout to host objects or to the IActiveScriptSite method.

SyntaxeSyntax

HRESULT InterruptScriptThread(  
    SCRIPTTHREADID   stidThread,  // identifier of thread  
    const EXCEPINFO *pexcepinfo,  // receives error information  
    DWORD dwFlags  
);  

ParamètresParameters

stidThread
[in] Identificateur du thread pour l’interruption ou l’une des valeurs d’identificateur de thread spécifique suivantes :[in] Identifier of the thread to interrupt, or one of the following special thread identifier values:

ValeurValue SignificationMeaning
SCRIPTTHREADID_ALLSCRIPTTHREADID_ALL Tous les threads.All threads. L’interruption est appliquée à toutes les méthodes de script en cours.The interrupt is applied to all script methods currently in progress. Notez que, sauf si l’appelant a demandé que le script déconnectés, l’événement sous forme de script suivant, le code de script pour exécuter à nouveau en appelant le IActiveScript::SetScriptState méthode avec le SCRIPTSTATE_DISCONNECTED ou L’indicateur SCRIPTSTATE_INITIALIZED défini.Note that unless the caller has requested that the script be disconnected, the next scripted event causes script code to run again by calling the IActiveScript::SetScriptState method with the SCRIPTSTATE_DISCONNECTED or SCRIPTSTATE_INITIALIZED flag set.
SCRIPTTHREADID_BASESCRIPTTHREADID_BASE Le thread de base ; Autrement dit, le thread dans lequel le script du moteur a été instancié.The base thread; that is, the thread in which the scripting engine was instantiated.
SCRIPTTHREADID_CURRENTSCRIPTTHREADID_CURRENT Le thread en cours d’exécution.The currently executing thread.

pexcepinfo
[in] Adresse d’un EXCEPINFO structure contenant les informations d’erreur qui doivent être signalées au script abandonné.[in] Address of an EXCEPINFO structure containing the error information that should be reported to the aborted script.

dwFlags
[in] Indicateurs d’option associés à l’interruption.[in] Option flags associated with the interruption. Peut avoir l'une des valeurs suivantes :Can be one of these values:

ValeurValue SignificationMeaning
SCRIPTINTERRUPT_DEBUGSCRIPTINTERRUPT_DEBUG Si la prise en charge, entrez le débogueur du moteur de script au point d’exécution de script actuel.If supported, enter the scripting engine's debugger at the current script execution point.
SCRIPTINTERRUPT_RAISEEXCEPTIONSCRIPTINTERRUPT_RAISEEXCEPTION Si la prise en charge par le langage de script du moteur, laisser le script de gérer l’exception.If supported by the scripting engine's language, let the script handle the exception. Sinon, la méthode de script est abandonnée et le code d’erreur est retourné à l’appelant ; Autrement dit, l’événement source ou la macro demandeur.Otherwise, the script method is aborted and the error code is returned to the caller; that is, the event source or macro invoker.

Valeur de retourReturn Value

Retourne l’une des valeurs suivantes :Returns one of the following values:

Valeur de retourReturn Value SignificationMeaning
S_OK Opération réussie.Success.
E_INVALIDARG Un argument n’était pas valide.An argument was invalid.
E_POINTER Un pointeur non valide a été spécifié.An invalid pointer was specified.
E_UNEXPECTED L’appel n’était pas attendu (par exemple, le moteur de script n'a pas encore été chargé ou initialisé).The call was not expected (for example, the scripting engine has not yet been loaded or initialized).

Voir aussiSee Also

IActiveScriptIActiveScript