IActiveScript::GetScriptThreadIDIActiveScript::GetScriptThreadID

Récupère un script du moteur-identificateur défini par le thread associé au thread Win32 donné.Retrieves a scripting-engine-defined identifier for the thread associated with the given Win32 thread.

SyntaxeSyntax

HRESULT GetScriptThreadID(  
    DWORD dwWin32ThreadID,       // Win32 thread identifier.  
    SCRIPTTHREADID *pstidThread  // Receives scripting thread. identifier  
);  

ParamètresParameters

dwWin32ThreadID ,dwWin32ThreadID ,
[in] Identificateur du thread d’un thread Win32 en cours d’exécution dans le processus actuel.[in] Thread identifier of a running Win32 thread in the current process. Utilisez le IActiveScript::GetCurrentScriptThreadID fonction pour récupérer l’identificateur du thread du thread en cours d’exécution.Use the IActiveScript::GetCurrentScriptThreadID function to retrieve the thread identifier of the currently executing thread.

pstidThread ,pstidThread ,
[out] Adresse d’une variable qui reçoit l’identificateur du thread de script associé au thread Win32 donné.[out] Address of a variable that receives the script thread identifier associated with the given Win32 thread. L’interprétation de cet identificateur est le moteur de script, mais il peut être une copie de l’identificateur de thread Windows.The interpretation of this identifier is left to the scripting engine, but it can be just a copy of the Windows thread identifier. Notez que si le thread Win32 se termine, cet identificateur devient non attribué et peut ensuite être attribué à un autre thread.Note that if the Win32 thread terminates, this identifier becomes unassigned and may subsequently be assigned to another thread.

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é) et par conséquent a échoué.The call was not expected (for example, the scripting engine has not yet been loaded or initialized) and therefore failed.

RemarquesRemarks

L’identificateur récupérée peut être utilisé dans les appels suivants aux méthodes de contrôle de l’exécution de thread script tel que le IActiveScript::InterruptScriptThread (méthode).The retrieved identifier can be used in subsequent calls to script thread execution control methods such as the IActiveScript::InterruptScriptThread method.

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 IActiveScript::InterruptScriptThread interface.This method can be called from non-base threads without resulting in a non-base callout to host objects or to the IActiveScript::InterruptScriptThread interface.

Voir aussiSee Also

IActiveScriptIActiveScript