IActiveScript::SetScriptState
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.
Syntax
HRESULT SetScriptState(
SCRIPTSTATE ss // identifier of new state
);
Parameters
ss
[in] Sets the scripting engine to the given state. Can be one of the values defined in the SCRIPTSTATE Enumeration enumeration.
Return Value
Returns one of the following values:
| 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. |
Remarks
For more information about scripting engine states, see the Script Engine States section of Windows Script Engines .
See also
IActiveScript::Clone
IActiveScript::GetScriptDispatch
IActiveScript::InterruptScriptThread
IActiveScriptParse::ParseScriptText
IActiveScriptSite::GetItemInfo