大网数据广告活动
.NET 与 C# 开发

CorBindToRuntimeEx 函数

· 52CE 我爱测

使非托管的宿主能够将公共语言运行时 (CLR) 加载到进程中。 CorBindToRuntime并CorBindToRuntimeEx函数执行相同的操作,但CorBindToRuntimeEx函数允许您设置标志以指定 CLR 的行为。

使非托管的宿主能够将公共语言运行时 (CLR) 加载到进程中。 CorBindToRuntime并CorBindToRuntimeEx函数执行相同的操作,但CorBindToRuntimeEx函数允许您设置标志以指定 CLR 的行为。

.NET Framework 4 中已弃用此函数。

此函数采用一组参数的允许主机以执行以下操作:

  • 指定要加载的运行时版本。

  • 指示是否应加载服务器或工作站生成。

  • 控制并发垃圾回收或非并发垃圾回收是否已完成。

Note: 在应用程序运行在 WOW64 中不支持并发垃圾回收 x86 仿真程序上实现 Intel Itanium 体系结构 (以前称为 IA-64) 的 64 位系统。 有关在 64 位 Windows 系统上使用 WOW64 的详细信息,请参阅运行 32 位应用程序。

  • 控制是否为非特定于域的加载程序集。

  • 获取到的接口指针ICorRuntimeHost可用来设置配置的 CLR 实例之前启动的其他选项。

语法

HRESULT CorBindToRuntimeEx (  
    [in]  LPCWSTR      pwszVersion,   
    [in]  LPCWSTR      pwszBuildFlavor,   
    [in]  DWORD        startupFlags,   
    [in]  REFCLSID     rclsid,   
    [in]  REFIID       riid,   
    [out] LPVOID FAR  *ppv  
);  

参数

pwszVersion
[in]想要加载的 CLR 版本描述的字符串。

.NET Framework 中的版本号用句点分隔的四个部分组成: major.minor.build.revision。 将字符串作为传递pwszVersion必须以字符"v"跟版本号 (例如,"v1.0.1529") 的前三个部分开头。

某些版本的 CLR 随指定与以前版本的 CLR 的兼容性的策略语句。 默认情况下,启动填充程序的计算结果pwszVersion针对策略语句和加载运行时的最新版本的是与所请求的版本兼容。 主机可以强制填充程序跳过策略评估和负载中指定的确切版本pwszVersion通过将的值传递STARTUP_LOADER_SAFEMODE为startupFlags参数,如下所述。

如果调用方指定为 null pwszVersion,CorBindToRuntimeEx标识已安装的运行时其版本号低于.NET Framework 4 运行时,并从该组中加载运行时的最新版本的组。 如果不安装任何早期版本,它不会加载.NET Framework 4 或更高版本,并且失败。 请注意,传递 null,则主机加载的运行时版本的任何控制。 虽然这种方法可能在某些情况下适用,但强烈建议主机提供一个要加载特定版本。

pwszBuildFlavor
[in]一个字符串,指定是否加载在服务器或工作站的 clr 版本。 有效值为 svr 和 wks。 服务器生成经过优化,可充分利用多个处理器,用于垃圾回收和工作站生成优化的单处理器计算机上运行的客户端应用程序。

如果pwszBuildFlavor设置为 null,则将加载工作站版本。 在单处理器计算机上运行时,工作站生成始终处于加载状态,即使pwszBuildFlavor设置为svr。 但是,如果pwszBuildFlavor设置为svr,并且指定并发垃圾回收 (请参阅的说明startupFlags参数),将加载服务器版本。

startupFlags
[in]值的组合STARTUP_FLAGS枚举。 这些标志控制并发垃圾回收、 非特定于域的代码和行为的pwszVersion参数。 如果未设置标志,则默认值为单一域。 以下为有效值:

  • STARTUP_CONCURRENT_GC

  • STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN

  • STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN

  • STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST

  • STARTUP_LOADER_SAFEMODE

  • STARTUP_LEGACY_IMPERSONATION

  • STARTUP_LOADER_SETPREFERENCE

  • STARTUP_SERVER_GC

  • STARTUP_HOARD_GC_VM

  • STARTUP_SINGLE_VERSION_HOSTING_INTERFACE

  • STARTUP_LEGACY_IMPERSONATION

  • STARTUP_DISABLE_COMMITTHREADSTACK

  • STARTUP_ALWAYSFLOW_IMPERSONATION

有关这些标志的说明,请参阅STARTUP_FLAGS枚举。

rclsid
[in]CLSID的实现的组件类ICorRuntimeHost或ICLRRuntimeHost接口。 支持的值为 CLSID_CorRuntimeHost 或 CLSID_CLRRuntimeHost。

riid
[in]IID从所请求的接口的rclsid。 支持的值为 IID_ICorRuntimeHost 或 IID_ICLRRuntimeHost。

ppv
[out]指向返回的接口指针riid。

备注

如果pwszVersion指定不存在,运行时版本CorBindToRuntimeEx返回 CLR_E_SHIM_RUNTIMELOAD 的 HRESULT 值。

执行上下文和流的 Windows 标识

在 CLR 版本 1xref:System.Security.Principal.WindowsIdentity对象不流经异步点,如新的线程,线程池或计时器回调。 在 2.0 版中的 clrxref:System.Threading.ExecutionContext对象封装有关当前正在执行的线程的一些信息,然后在任何异步点,但不是会跨应用程序域边界。 同样,xref:System.Security.Principal.WindowsIdentity对象还上任何异步点流动。 因此,在线程上的当前模拟如果有的话,也会流动。

您可以更改以下两种方式流:

  1. 通过修改xref:System.Threading.ExecutionContext设置,以禁止显示上每个线程进行的流 (请参阅xref:System.Threading.ExecutionContext.SuppressFlow*, xref:System.Security.SecurityContext.SuppressFlow*,和xref:System.Security.SecurityContext.SuppressFlowWindowsIdentity*方法)。

  2. 通过更改进程的默认模式为第 1 版兼容性模式,其中xref:System.Security.Principal.WindowsIdentity对象不流经异步的任何时刻,而不考虑xref:System.Threading.ExecutionContext当前线程上的设置。 如何更改默认模式取决于是否使用托管可执行文件或使用非托管承载接口能够将 CLR 加载:

    1. 用于托管可执行文件,必须设置enabled的属性 <legacyImpersonationPolicy >元素true。

    2. 对于非托管承载接口,将STARTUP_LEGACY_IMPERSONATION中的标志startupFlags参数调用时CorBindToRuntimeEx函数。

    第 1 版兼容性模式适用于整个过程和进程中的所有应用程序域。

要求

平台: 请参阅系统需求。

标头: MSCorEE.h

库: MSCorEE.dll

.NET Framework 版本: 自 1.0 之后可用

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 rpetrusha)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。