IActiveScript::GetScriptThreadStateIActiveScript::GetScriptThreadState

Récupère l’état actuel d’un thread de script.Retrieves the current state of a script thread.

SyntaxeSyntax

HRESULT GetScriptThreadState(  
    SCRIPTTHREADID stidThread,    // identifier of script thread  
    SCRIPTTHREADSTATE *pstsState  // receives state flag  
);  

ParamètresParameters

stidThread
[in] Identificateur du thread dont l’état est souhaité, ou un des identificateurs de thread spéciaux suivants :[in] Identifier of the thread for which the state is desired, or one of the following special thread identifiers:

ValeurValue SignificationMeaning
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.

pstsState
[out] Adresse d’une variable qui reçoit l’état du thread indiqué.[out] Address of a variable that receives the state of the indicated thread. L’état est indiqué par une des valeurs constantes nommées définies par le scriptthreadstate, énumération énumération.The state is indicated by one of the named constant values defined by the SCRIPTTHREADSTATE Enumeration enumeration. Si ce paramètre n’identifie pas le thread en cours, l’état peut changer à tout moment.If this parameter does not identify the current thread, the state may change at any time.

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_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).

RemarquesRemarks

Cette méthode peut être appelée à 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 interface.This method can be called from non-base threads without resulting in a non-base callout to host objects or to the IActiveScriptSite interface.

Voir aussiSee Also

IActiveScriptIActiveScript