ILocalRegistry2.CreateInstance 方法 (Guid, Object, Guid%, UInt32, IntPtr%)

项目
10/25/2012

在本地注册表列表中创建的类的实例。

命名空间： Microsoft.VisualStudio.Shell.Interop
程序集： Microsoft.VisualStudio.Shell.Interop（在 Microsoft.VisualStudio.Shell.Interop.dll 中）

语法

声明
Function CreateInstance ( _
    clsid As Guid, _
    punkOuter As Object, _
    ByRef riid As Guid, _
    dwFlags As UInteger, _
    <OutAttribute> ByRef ppvObj As IntPtr _
) As Integer

int CreateInstance(
    Guid clsid,
    Object punkOuter,
    ref Guid riid,
    uint dwFlags,
    out IntPtr ppvObj
)

参数

clsid
类型：System.Guid
[in] 类标识符 (CLSID) 请求的对象。这是 CLSID 与用于创建对象的数据和代码。

punkOuter
类型：System.Object
[in] 对复合的 IUnknown 控件实例的指针使用新创建的对象。nullnull 引用（在 Visual Basic 中为 Nothing）的值指示充当聚合一部分，就不能创建对象。如果非 null，这是指针对复合对象的 IUnknown 接口 (控件 IUnknown)。

riid
类型：System.Guid%
[in] 要使用的界面与对象进行通信。例如 IID_IClassFactory。

dwFlags
类型：System.UInt32
[in] 控件从 CLSCTX 枚举的标志实例的创建。指定 CLSCTX_INPROC_SERVER的值。

ppvObj
类型：System.IntPtr%
[out] 的指针变量地址接收接口指针在 riid请求。在成功返回， ppvObj 包含请求的接口指针。在失败， ppvObj 包含 nullnull 引用（在 Visual Basic 中为 Nothing）。

返回值

类型：System.Int32
如果方法成功，则返回 S_OK。如果失败，它会返回一个错误代码。

备注

COM 签名

从 objext.idl:

HRESULT ILocalRegistry2::CreateInstance(

[in] CLSID clsid,

[in] IUnknown* punkOuter,

[in] REFIID riid,

[in] DWORD dwFlags,

[out] void** ppvObj

);

CreateInstance 方法使用 COM 的 CoCreateInstance 功能等效的。它创建类型的单个未初始化的对象与指定的 CLSID 并返回所有请求的接口指针。

CreateInstance 查找在注册的对象本地注册表类的对象，连接到类对象与指定的 CLSID，创建对象的未初始化的实例，并释放类的对象。此方法封装对 COM 函数 CoGetClassObject 获取指向对象类工厂并对 CreateInstance 创建对象的实例并释放对类工厂对象。

说明
，如果要创建基于 CLSID 的对象的一个实例，并不需要将类工厂对象创建对象的其他实例后，调用 CreateInstance 。创建从单个类对象的多个对象，请使用该 2.GetClassObjectOfClsid M:Microsoft.VisualStudio.Shell.Interop.ILocalRegistry(System.Guid@、 System.UInt32、 System.IntPtr、 System.Guid@， System.IntPtr) 方法。