WPRCCreateInstanceUnderInstanceName

此函数用于创建指定类的实例,并带有指定实例名称的选项。

语法

HRESULT WPRCCreateInstanceUnderInstanceName(
    _In_opt_ BSTR bstrInstanceName,
    _In_ REFCLSID rclsid,
    _In_opt_ LPUNKNOWN pUnkOuter,
    _In_ DWORD dwClsContext,
    _In_ REFIID riid,
    _Outptr_ LPVOID *ppv
);

参数

bstrInstanceName

In_opt BSTR):可选。 实例的名称。 如果此参数为 NULL,则该函数将创建一个未命名的实例。

rclsid

(In REFCLSID):与将用于创建对象的数据和代码关联的 CLSID。

pUnkOuter

In_opt LPUNKNOWN):可选。 如果为 NULL,则表示对象不是作为聚合的一部分创建的。 如果为非 NULL,则指针指向聚合对象的 IUnknown 接口(控制 IUnknown)。

dwClsContext

(In DWORD):管理新创建对象的代码将在其中运行的上下文。 这些值取自枚举类 CLSCTX

riid

(In REFIID):对用于与对象通信的接口的标识符的引用。

ppv

(Outptr LPVOID):接收 riid 中请求的接口指针的指针变量的地址。 成功返回后,*ppv 包含请求的接口指针。

返回值

该函数返回 HRESULT 代码。 成功执行通常由 S_OK 指示。 失败由任何其他 HRESULT 代码指示,表示在执行函数期间发生了错误。

注解

函数