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 代码指示,表示在执行函数期间发生了错误。