获取指定索引位置的程序集标识。
语法
HRESULT Get (
[in] DWORD dwIndex,
[out, size_is(*pcchBufferSize)] LPWSTR pwzBuffer,
[in, out] DWORD *pcchBufferSize
);
参数
dwIndex [in]要返回的程序集标识的从零开始的索引。
pwzBuffer [out]包含程序集标识数据的缓冲区。
pcchBufferSize [in, out]缓冲区的大小 pwzBuffer 。
返回值
| HRESULT | 说明 |
|---|---|
| S_OK | 已成功返回 Get。 |
| ERROR_INSUFFICIENT_BUFFER | pwzBuffer 太小。 |
| ERROR_NO_MORE_ITEMS | 枚举不包含更多项。 |
| HOST_E_CLRNOTAVAILABLE | 公共语言运行时 (CLR) 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
| HOST_E_TIMEOUT | 调用超时。 |
| HOST_E_NOT_OWNER | 调用方未持有锁。 |
| HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
| E_FAIL | 发生未知的灾难性故障。 如果方法返回 E_FAIL,则进程中无法再使用 CLR。 后续调用任何承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
备注
索引 0 的标识是特定于处理器体系结构的标识。 索引 1 的标识是公共中间语言(CIL)的体系结构中性程序集。 索引 2 的标识不包含体系结构信息。
Get 通常会调用两次。 第一次调用为 pwzBuffer 提供 null 值,并将 pcchBufferSize 设置为适合 pwzBuffer 的大小。 第二次调用提供适当大小的 pwzBuffer,并包含完成时规范程序集标识数据。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用