Contents Index Topic Contents
	Previous Topic: IActiveScript::SetScriptSite Next Topic: IActiveScriptError

IActiveScript::SetScriptState

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.

• Returns one of the following values:

  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.

ss

[in] Sets the scripting engine to the given state. Can be one of the values defined in the SCRIPTSTATE enumeration.

For more information about scripting engine states, see Script Engine States.

See also IActiveScript::Clone, IActiveScript::GetScriptDispatch, IActiveScript::InterruptScriptThread, IActiveScriptParse::ParseScriptText, IActiveScriptSite::GetItemInfo

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.