DebugCreate 函数 (dbgeng.h)

DebugCreate 函数创建新的客户端对象,并返回指向它的接口指针。

语法

HRESULT DebugCreate(
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

参数

[in] InterfaceId

指定所需调试器引擎客户端接口 (IID) 接口标识符。 这是将在接口中返回的 接口的类型。 有关接口标识符的信息,请参阅 使用客户端对象

[out] Interface

接收新客户端的接口指针。 此接口的类型由 InterfaceId 指定。

返回值

此方法也可能返回其他错误值。 有关更多详细信息 ,请参阅返回值

返回代码 说明
S_OK
函数成功。
E_NOINTERFACE
客户端对象不实现指定的接口。

注解

传递给 DebugCreate 的参数 与传递给 IUnknown::QueryInterface 的参数相同,并且以相同的方式处理它们。

IUnknown::QueryInterface 一样,当不再需要返回的接口时,应调用其 IUnknown::Release 方法。

无需调用 CoInitializeCoInitializeExOleInitialize 即可使用此函数及其获取的接口。

无法通过调用 CoCreateInstance、CoCreateInstanceExCoGetClassObject 来获取调试器引擎客户端接口。 使用 DebugCreateDebugCreateExDebugConnectDebugConnectWide 创建此类接口,或在另一个调试器引擎客户端接口上调用 IUnknown::QueryInterface

要求

要求
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

客户端对象