使非托管的宿主能够将公共语言运行时 (CLR) 加载到进程中。
.NET Framework 4 中已弃用此函数。
语法
HRESULT CorBindToRuntime (
[in] LPCWSTR pwszVersion,
[in] LPCWSTR pwszBuildFlavor,
[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为flags参数,如下所述。
如果调用方指定为 null pwszVersion,加载的运行时的最新版本。 传递 null 不,则主机加载的运行时版本的任何控制。 虽然这种方法可能在某些情况下适用,但强烈建议主机提供一个要加载特定版本。
pwszBuildFlavor
[in]一个字符串,指定是否加载在服务器或工作站的 clr 版本。 有效值为 svr 和 wks。 服务器生成经过优化,可充分利用多个处理器,用于垃圾回收和工作站生成优化的单处理器计算机上运行的客户端应用程序。
如果pwszBuildFlavor设置为 null,则将加载工作站版本。 在单处理器计算机上运行时,工作站生成始终处于加载状态,即使pwszBuildFlavor设置为svr。 但是,如果pwszBuildFlavor设置为svr,并且指定并发垃圾回收 (请参阅的说明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对象还上任何异步点流动。 因此,在线程上的当前模拟如果有的话,也会流动。
您可以更改以下两种方式流:
-
通过修改xref:System.Threading.ExecutionContext设置,以禁止显示上每个线程进行的流 (请参阅xref:System.Threading.ExecutionContext.SuppressFlow*, xref:System.Security.SecurityContext.SuppressFlow*,和xref:System.Security.SecurityContext.SuppressFlowWindowsIdentity*方法)。
-
通过更改进程的默认模式为第 1 版兼容性模式,其中xref:System.Security.Principal.WindowsIdentity对象不流经异步的任何时刻,而不考虑xref:System.Threading.ExecutionContext当前线程上的设置。 如何更改默认模式取决于是否使用托管可执行文件或使用非托管承载接口能够将 CLR 加载:
-
用于托管可执行文件,必须设置
enabled的属性 <legacyImpersonationPolicy >元素true。 -
对于非托管承载接口,将
STARTUP_LEGACY_IMPERSONATION中的标志flags参数调用时CorBindToRuntimeEx函数。
第 1 版兼容性模式适用于整个过程和进程中的所有应用程序域。
-
备注
CorBindToRuntimeEx并CorBindToRuntime执行相同的操作,但CorBindToRuntimeEx函数允许您设置标志以指定 CLR 的行为。
要求
平台: 请参阅系统需求。
标头: MSCorEE.h
库: MSCorEE.dll
.NET Framework 版本: 自 1.0 之后可用
请参阅
- CorBindToCurrentRuntime 函数
- CorBindToRuntimeByCfg 函数
- CorBindToRuntimeEx 函数
- CorBindToRuntimeHost 函数
- ICorRuntimeHost 接口
- 弃用的 CLR 承载函数
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 rpetrusha)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
