home *** CD-ROM | disk | FTP | other *** search
/ io Programmo 40 / IOPROG_40.ISO / SOFT / NETFrameworkSDK.exe / comsdk.cab / mscoree.idl < prev    next >
Encoding:
Text File  |  2000-06-23  |  16.0 KB  |  375 lines
  1. /**************************************************************************************
  2.  **                                                                                  **
  3.  ** Mscoree.idl - interface definitions for mscoree.dll                              **
  4.  **                                                                                  **
  5.  ** Copyright (c) 1996-2000 Microsoft Corporation.  All Rights Reserved.             **
  6.  **                                                                                  **
  7.  **************************************************************************************/
  8.  
  9. //
  10. // Interface descriptions
  11. //
  12. import "unknwn.idl";
  13. import "gchost.idl";
  14. import "ivalidator.idl";
  15.  
  16. // LIBID mscoree
  17. cpp_quote("extern const GUID __declspec(selectany) LIBID_mscoree = {0x5477469e,0x83b1,0x11d2,{0x8b,0x49,0x00,0xa0,0xc9,0xb7,0xc9,0xc4}};")
  18.  
  19. // CLSID CorRuntimeHost : uuid(CB2F6723-AB3A-11d2-9C40-00C04FA30A3E)
  20. cpp_quote("extern const GUID  __declspec(selectany) CLSID_CorRuntimeHost = { 0xcb2f6723, 0xab3a, 0x11d2, { 0x9c, 0x40, 0x00, 0xc0, 0x4f, 0xa3, 0x0a, 0x3e } };")
  21.  
  22. // CLSID ComCallUnmarshall
  23. cpp_quote("extern const GUID __declspec(selectany) CLSID_ComCallUnmarshal = {0x3F281000,0xE95A,0x11d2,{0x88,0x6B,0x00,0xC0,0x4F,0x86,0x9F,0x04}};")
  24.  
  25. // IID IObjectHandle : uuid(C460E2B4-E199-412a-8456-84DC3E4838C3)
  26. cpp_quote("extern const GUID __declspec(selectany) IID_IObjectHandle = { 0xc460e2b4, 0xe199, 0x412a, { 0x84, 0x56, 0x84, 0xdc, 0x3e, 0x48, 0x38, 0xc3 } };")
  27.  
  28.  
  29. // IID IManagedObject : uuid(C3FCC19E-A970-11d2-8B5A-00A0C9B7C9C4)
  30. cpp_quote("extern const GUID  __declspec(selectany) IID_IManagedObject = { 0xc3fcc19e, 0xa970, 0x11d2, { 0x8b, 0x5a, 0x00, 0xa0, 0xc9, 0xb7, 0xc9, 0xc4 } };")
  31.  
  32. // IID ICorRuntimeHost : uuid(CB2F6722-AB3A-11d2-9C40-00C04FA30A3E)
  33. cpp_quote("extern const GUID  __declspec(selectany) IID_ICorRuntimeHost = { 0xcb2f6722, 0xab3a, 0x11d2, { 0x9c, 0x40, 0x00, 0xc0, 0x4f, 0xa3, 0x0a, 0x3e } };")
  34.  
  35. // IID ICorThreadpool : uuid(84680D3A-B2C1-46e8-ACC2-DBC0A359159A)
  36. cpp_quote("extern const GUID  __declspec(selectany) IID_ICorThreadpool = { 0x84680D3A, 0xB2C1, 0x46e8, {0xAC, 0xC2, 0xDB, 0xC0, 0xA3, 0x59, 0x15, 0x9A } };")
  37.  
  38. #pragma midl_echo("STDAPI GetCORSystemDirectory(LPWSTR pbuffer, DWORD  cchBuffer, DWORD* dwlength);")
  39. #pragma midl_echo("STDAPI GetCORVersion(LPWSTR pbuffer, DWORD cchBuffer, DWORD* dwlength);")
  40. #pragma midl_echo("STDAPI CorBindToRuntime(LPWSTR pwszVersion, LPWSTR pwszBuildFlavor, REFCLSID rclsid, REFIID riid, LPVOID FAR *ppv);")
  41. #pragma midl_echo("STDAPI CorBindToCurrentRuntime(LPCWSTR pwszFileName, REFCLSID rclsid, REFIID riid, LPVOID FAR *ppv);")
  42. #pragma midl_echo("STDAPI RunDll32ShimW(HWND hwnd, HINSTANCE hinst, LPWSTR lpszCmdLine, int nCmdShow);")
  43. #pragma midl_echo("STDAPI LoadLibraryShim(LPCWSTR szDllName, LPCWSTR szVersion, LPVOID pvReserved, HMODULE *phModDll);")
  44. #pragma midl_echo("STDAPI GetRealProcAddress(LPCSTR pwszProcName, VOID** ppv);")
  45. #pragma midl_echo("void STDMETHODCALLTYPE CorExitProcess();")
  46.  
  47. typedef enum {
  48.     STARTUP_CONCURRENT_GC = 0x1
  49. } STARTUP_FLAGS;
  50.  
  51. //*****************************************************************************
  52. // Interface for Object Handles
  53. //*****************************************************************************
  54. [
  55.     object,
  56.     oleautomation,
  57.     uuid(C460E2B4-E199-412a-8456-84DC3E4838C3),
  58.     helpstring("Object Handle Interface"),
  59.     pointer_default(unique)
  60. ]
  61. interface IObjectHandle : IUnknown
  62. {
  63.         HRESULT Unwrap([out, retval] VARIANT *ppv);
  64. };
  65.  
  66.  
  67.  
  68.  
  69. //*****************************************************************************
  70. // Interface for Setting runtime configuration
  71. //*****************************************************************************
  72. // {5C2B07A7-1E98-11d3-872F-00C04F79ED0D}
  73. //cpp_quote("extern const GUID  __declspec(selectany) IID_AppDomainBinding= { 0x5c2b07a7, 0x1e98, 0x11d3, { 0x87, 0x2f, 0x00, 0xc0, 0x4f, 0x79, 0xed, 0x0d } };")
  74. [
  75.         uuid(5C2B07A7-1E98-11d3-872F-00C04F79ED0D),
  76.         version(1.0), 
  77.         helpstring("Application Domain call back"),
  78.         pointer_default(unique),
  79.         local
  80. ] 
  81. interface IAppDomainBinding : IUnknown
  82. {
  83.     // TODO: this should return a AppDomain interface
  84.     // The event is invoked everytime a domain is created 
  85.     HRESULT OnAppDomain([in] IUnknown* pAppdomain);
  86. }
  87.  
  88.  
  89. //*****************************************************************************
  90. // Interface for participating in the scheduling of threads that would
  91. // otherwise be blocked for a GC
  92. //*****************************************************************************
  93. [
  94.         uuid(F31D1788-C397-4725-87A5-6AF3472C2791),
  95.         version(1.0),
  96.         helpstring("Control over threads blocked in GC"),
  97.         pointer_default(unique),
  98.         local
  99. ]
  100. interface IGCThreadControl : IUnknown
  101. {
  102.         // Notification that the thread making the call is about to block, perhaps for
  103.         // a GC or other suspension.  This gives the host an opportunity to re-schedule
  104.         // the thread for unmanaged tasks.
  105.         HRESULT ThreadIsBlockingForSuspension();
  106.  
  107.         // Notification that the runtime is beginning a thread suspension for a GC or
  108.         // other suspension.  Do not reschedule this thread!
  109.         HRESULT SuspensionStarting();
  110.  
  111.         // Notification that the runtime is resuming threads after a GC or other
  112.         // suspension.  Do not reschedule this thread!
  113.         HRESULT SuspensionEnding(DWORD Generation);
  114. }
  115.  
  116. //*****************************************************************************
  117. // Interface for accessing threadpool 
  118. //*****************************************************************************
  119. typedef VOID (__stdcall *WAITORTIMERCALLBACK)(PVOID, BOOL); 
  120. typedef DWORD (__stdcall *LPTHREAD_START_ROUTINE)(LPVOID lpThreadParameter);
  121. cpp_quote("#ifdef UNDER_CE")
  122. typedef VOID (*LPOVERLAPPED_COMPLETION_ROUTINE)(DWORD dwErrorCode,
  123.                                                 DWORD dwNumberOfBytesTransfered,
  124.                                                 LPVOID lpOverlapped);
  125. cpp_quote("#endif // UNDER_CE")
  126. [
  127.         uuid(84680D3A-B2C1-46e8-ACC2-DBC0A359159A),
  128.         version(1.0),
  129.         helpstring("Threadpool interface"),
  130.         pointer_default(unique),
  131.         local
  132. ]
  133. interface ICorThreadpool : IUnknown
  134. {
  135.                 HRESULT CorRegisterWaitForSingleObject([in] HANDLE* phNewWaitObject,
  136.                                             [in] HANDLE hWaitObject,
  137.                                             [in] WAITORTIMERCALLBACK Callback,
  138.                                             [in] PVOID Context,
  139.                                             [in] ULONG timeout,
  140.                                             [in] BOOL  executeOnlyOnce,
  141.                                                                                         [out] BOOL* result  );
  142.  
  143.                 HRESULT CorUnregisterWait([in] HANDLE hWaitObject,[in] HANDLE CompletionEvent,[out] BOOL* result);
  144.  
  145.                 HRESULT CorQueueUserWorkItem([in] LPTHREAD_START_ROUTINE Function,
  146.                                   [in] PVOID Context,
  147.                                   [in] BOOL executeOnlyOnce,
  148.                                                                   [out] BOOL* result );
  149.  
  150.  
  151.                 HRESULT CorCreateTimer([in] HANDLE* phNewTimer,
  152.                             [in] WAITORTIMERCALLBACK Callback,
  153.                             [in] PVOID Parameter,
  154.                             [in] DWORD DueTime,
  155.                             [in] DWORD Period,
  156.                                                         [out] BOOL* result);
  157.  
  158.                 HRESULT CorChangeTimer([in] HANDLE Timer, [in] ULONG DueTime, [in] ULONG Period, [out] BOOL* result);
  159.  
  160.                 HRESULT CorDeleteTimer([in] HANDLE Timer, [in] HANDLE CompletionEvent, [out] BOOL* result);
  161.  
  162.                 HRESULT CorBindIoCompletionCallback([in] HANDLE fileHandle, [in] LPOVERLAPPED_COMPLETION_ROUTINE callback); 
  163. }
  164.  
  165. [
  166.         uuid(23D86786-0BB5-4774-8FB5-E3522ADD6246),
  167.         version(1.0),
  168.         helpstring("Control over threads blocked in debugging services"),
  169.         pointer_default(unique),
  170.         local
  171. ]
  172. interface IDebuggerThreadControl : IUnknown
  173. {
  174.         // Notification that the thread making the call is about to
  175.         // block within the debugging services.  This gives the host
  176.         // an opportunity to perform another action while the thread
  177.         // blocks. This will always be called on a Runtime thread.
  178.         HRESULT ThreadIsBlockingForDebugger();
  179.  
  180.         // Notification that the debugging services is about to
  181.         // release all threads it has blocked. This will never be
  182.         // called on a Runtime thread. If the host has a Runtime
  183.         // thread blocked in ThreadIsBlockingForDebugger() then it
  184.         // should release it now.
  185.         HRESULT ReleaseAllRuntimeThreads();
  186. }
  187.  
  188. // {5C2B07A5-1E98-11d3-872F-00C04F79ED0D}
  189. //cpp_quote("extern const GUID  __declspec(selectany) IID_ICorConfiguration = { 0x5c2b07a5, 0x1e98, 0x11d3, { 0x87, 0x2f, 0x00, 0xc0, 0x4f, 0x79, 0xed, 0x0d } };")
  190. [
  191.         uuid(5C2B07A5-1E98-11d3-872F-00C04F79ED0D),
  192.         version(1.0), 
  193.         helpstring("Com+ Configuration Interface"),
  194.         pointer_default(unique),
  195.         local
  196. ] 
  197. interface ICorConfiguration : IUnknown
  198. {
  199.     // The event is invoked everytime a domain is created 
  200.     HRESULT SetAppDomainLoadEvent([in] IAppDomainBinding* pAppStartEvent);
  201.  
  202.     // Set the callback for scheduling threads for non-runtime tasks when they
  203.     // would otherwise be blocked for a GC.
  204.     HRESULT SetGCThreadControl([in] IGCThreadControl* pGCThreadControl);
  205.  
  206.     // Set the callback interface that the debugging services will
  207.     // call as Runtime threads are blocked and un-blocked for
  208.     // debugging.
  209.     HRESULT SetDebuggerThreadControl([in] IDebuggerThreadControl* pDebuggerThreadControl);
  210.  
  211.     // The host may indicate to the debugging services that a
  212.     // particular thread should be allowed to continue to execute
  213.     // while the debugger has an application stopped during
  214.     // managed/unmanaged debugging scenarios. The specified thread
  215.     // will not be allowed to run managed code, or to enter the
  216.     // Runtime in any way. An example of such a thread would be an
  217.     // in-process thread to support legacy script debuggers.
  218.     HRESULT AddDebuggerSpecialThread([in] DWORD dwSpecialThreadId);
  219. }
  220.  
  221. //*****************************************************************************
  222. // Interface for hosting mscoree
  223. //*****************************************************************************
  224. typedef void* HDOMAINENUM;
  225.  
  226. [
  227.         uuid(CB2F6722-AB3A-11d2-9C40-00C04FA30A3E),
  228.         version(1.0), 
  229.         helpstring("Com+ Runtime Hosting Interface"),
  230.         pointer_default(unique),
  231.         local
  232. ] 
  233. interface ICorRuntimeHost : IUnknown
  234. { 
  235.  
  236.     //=================================================================
  237.     //
  238.     // Depricated methods.
  239.  
  240.     HRESULT VerifyClassesInModule( 
  241.      [in] DWORD   BaseAddress);      // Base Address of the file to verify.
  242.  
  243.     HRESULT CreateFiberInfo();
  244.     HRESULT DeleteFiber();
  245.     HRESULT SwitchFiberIn(
  246.      [in] DWORD *pFiberCookie);       // [in] Cookie that indicates the fiber to use.
  247.  
  248.     HRESULT SwitchFiberOut(
  249.      [out]   DWORD **pFiberCookie);   // [out] Cookie that indicates the fiber being switched out.
  250.  
  251.     HRESULT MapFile(
  252.      [in]   ULONG       hFile,           // [in]  HANDLE for file
  253.      [out]  HMODULE*    hMapAddress);    // [out] HINSTANCE for mapped file
  254.  
  255.     //=================================================================
  256.     //
  257.     // New hosting methods
  258.     //
  259.     // Returns an object for configuring the runtime prior to 
  260.     // it starting. If the runtime has been initialized this
  261.     // routine returns an error. See ICorConfiguration.
  262.     HRESULT GetConfiguration([out] ICorConfiguration** pConfiguration);
  263.  
  264.     // Starts the runtime. This is equivalent to CoInitializeCor();
  265.     HRESULT Start();
  266.     
  267.     // Terminates the runtime, This is equivalent CoUninitializeCor();
  268.     HRESULT Stop();
  269.     
  270.     // Creates a domain in the runtime. The identity array is 
  271.     // a pointer to an array TYPE containing IIdentity objects defining
  272.     // the security identity. The policy array is a pointer to an array
  273.     // TYPE containing Context policies that added on in addition to the
  274.     // basic policies for a AppDomain.
  275.     HRESULT CreateDomain([in] LPWSTR pwzFriendlyName,   // Optional
  276.                          [in] IUnknown* pIdentityArray, // Optional
  277.                          [in] IUnknown* pPolicyArray,   // Optional
  278.                          [out] IUnknown** pAppDomain);
  279.     
  280.     // Creates a domain in the runtime. A proxy controls a single
  281.     // domain. But provides more control over the domain.
  282.     HRESULT CreateDomainProxy([in] LPWSTR pwzFriendlyName,   // Optional
  283.                               [in] IUnknown* pIdentityArray, // Optional
  284.                               [in] IUnknown* pPolicyArray,   // Optional
  285.                               [out] IUnknown** pDomainProxy);
  286.     
  287.     // Returns the default domain.
  288.     HRESULT GetDefaultDomain([out] IUnknown** pAppDomain);
  289.     
  290.     
  291.     // Enumerate currently existing domains. 
  292.     HRESULT EnumDomains([out] HDOMAINENUM *hEnum);
  293.     
  294.     // Returns S_FALSE when there are no more domains. A domain
  295.     // is passed out only when S_OK is returned.
  296.     HRESULT NextDomain([in] HDOMAINENUM hEnum,
  297.                        [out] IUnknown** pAppDomain);
  298.     
  299.     // Resets the enumeration back to the beginning of the
  300.     // list
  301.     HRESULT ResetDomainEnum([in] HDOMAINENUM hEnum);
  302.     
  303.     // Close the enumeration releasing resources
  304.     HRESULT CloseEnum([in] HDOMAINENUM hEnum);
  305.  
  306.     // Verifies an assembly. This allows an assembly to be checked prior   
  307.     // to adding it to a domain. The assembly is not mapped into any 
  308.     // Assembly
  309.     HRESULT VerifyAssembly([in, size_is(cbModule)] BYTE* pbModule, // Base Address of the file to verify.
  310.                            [in] DWORD cbModule,
  311.                            [in, size_is(errorSize)] LONG* errors,
  312.                            [in] DWORD errorSize,
  313.                            [out] DWORD* errorCount);
  314.     
  315.     // Verifies an assembly. This allows an assembly to be checked prior 
  316.     // to adding it to a domain. The assembly is loaded into the default
  317.     // Domain and returned. 
  318.     HRESULT VerifyAssemblyFile([in] LPWSTR,
  319.                                [in, size_is(errorSize)] LONG* errors,
  320.                                [in] DWORD errorSize,
  321.                                [out] DWORD* errorCount);
  322.     
  323. }; 
  324.  
  325.  
  326. //*****************************************************************************
  327. // mscoree typelib definition
  328. //*****************************************************************************
  329.  
  330. [
  331.         uuid(5477469e-83b1-11d2-8b49-00a0c9b7c9c4),
  332.         version(1.0),
  333.         helpstring("Com+ Runtime Execution Engine 1.0 Type Library")
  334. ]
  335. library mscoree
  336. {
  337.         importlib("stdole32.tlb");
  338.         //*****************************************************************************
  339.         // Interface for controlling a managed object
  340.         //*****************************************************************************
  341.         [
  342.                          object,
  343.                 oleautomation,
  344.                         uuid(C3FCC19E-A970-11d2-8B5A-00A0C9B7C9C4),
  345.                 helpstring("Managed Object Interface"),
  346.                 pointer_default(unique)
  347.         ]
  348.         interface IManagedObject : IUnknown
  349.         {
  350.                         HRESULT GetSerializedBuffer( [out] BSTR *pBSTR);
  351.         };
  352.  
  353.  
  354.     [
  355.             uuid(3F281000-E95A-11d2-886B-00C04F869F04),
  356.             helpstring("Com Call Wrapper Unmarshalling Class")
  357.     ]
  358.     coclass ComCallUnmarshal
  359.     {
  360.             [default] interface IMarshal;
  361.     };
  362.  
  363.     [
  364.      uuid(CB2F6723-AB3A-11d2-9C40-00C04FA30A3E),
  365.      helpstring("Cor Runtime Hosting Class")
  366.     ]
  367.     coclass CorRuntimeHost
  368.     {
  369.         [default] interface ICorRuntimeHost;
  370.         interface IGCHost;
  371.         interface IValidator;
  372.     };
  373.  
  374. };
  375.