DebugCreateEx 函数 (dbgeng.h)

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

语法

HRESULT DebugCreateEx(
  [in]  REFIID InterfaceId,
  [in]  DWORD  DbgEngOptions,
  [out] PVOID  *Interface
);

参数

[in] InterfaceId

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

[in] DbgEngOptions

提供调试器选项标志。

[out] Interface

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

返回值

此方法还可以返回其他错误值。 有关详细信息,请参阅 返回值

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

言论

传递给 DebugCreateEx 的参数与传递给 IUnknown::QueryInterface的参数相同,它们受到相同的处理方式。

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

无需调用 CoInitializeCoInitializeEx,或 OleInitialize 来使用此函数和接口。

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

要求

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

另请参阅

客户端函数

客户端对象