Microsoft® Windows® Script Interfaces IActiveScript::SetScriptState |
Language Reference Previous Next |
HRESULT SetScriptState( SCRIPTSTATE ss // identifier of new state );
Puts the scripting engine into the given state. This method can be called from non-base threads without resulting in a non-base callout to host objects or to the IActiveScriptSite interface.
Return Value | Meaning |
S_OK | Success. |
E_FAIL | The scripting engine does not support the transition back to the initialized state. The host must discard this scripting engine and create, initialize, and load a new scripting engine to achieve the same effect. |
E_UNEXPECTED | The call was not expected (for example, the scripting engine has not yet been loaded or initialized) and therefore failed. |
OLESCRIPT_S_PENDING | The method was queued successfully, but the state has not changed yet. When the state changes, the site will be called back through the IActiveScriptSite::OnStateChange method. |
S_FALSE | The method succeeded, but the script was already in the given state. |
For more information about scripting engine states, see Script Engine States.
See also IActiveScript::Clone, IActiveScript::GetScriptDispatch, IActiveScript::InterruptScriptThread, IActiveScriptParse::ParseScriptText, IActiveScriptSite::GetItemInfo