Gets the compiled state of a script engine, and, optionally, associated debugging information.
[Visual Basic] Sub GetCompiledState( _ <Out()> ByRef pe() As Byte, _ <Out()> ByRef debugInfo() As Byte _ ) [C#] void GetCompiledState( out byte pe, out byte debugInfo ); [C++] void GetCompiledState( [ Out ] unsigned char* pe __gc, [ Out ] unsigned char* debugInfo __gc ); [JScript] function GetCompiledState( pe : Byte, debugInfo : Byte );
- The compiled state of the engine; an assembly in byte form.
- The debugging information for the assembly, or a null reference if such information does not exist or is not available.
The host initially stores a script engine's compiled state along with debugging information, if available, using the IVsaEngine.SaveCompiledState method and specifying a location to which the compiled state should be persisted. The compiled state of the engine is uniquely identified by the IVsaEngine.RootMoniker property of the script engine that is currently associated with the IVsaSite object.
If debugging information is not available or does not exist, you will be unable to resolve breakpoints in the debugger.
This method is only called by an engine subsequent to a call by the host to the IVsaEngine.Run method. It should not be called at any other time.
A default implementation of the IVsaSite interface, including use of the GetCompiledState method, is provided in Microsoft.Vsa.BaseVsaSite, which is available on the Visual Studio for Applications SDK. BaseVsaSite implements two properties, Assembly and DebugInfo, to get the compiled state. You can derive from this class to provide specific functionality.
The following table shows the exceptions that the GetCompiledState method can throw.
|GetCompiledStateFailed||The compiled state could not be loaded.|
|CompiledStateNotFound||There was no existing compiled state for the engine.|
|CallbackUnexpected||The host was not expecting a call at this time.|
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family