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 方法。

无需调用 CoInitialize、 CoInitializeEx 或 OleInitialize 即可使用此函数及其获取的接口。

无法通过调用 CoCreateInstance、CoCreateInstanceEx 或 CoGetClassObject 来获取调试器引擎客户端接口。 使用 DebugCreate、 DebugCreateEx、 DebugConnect 或 DebugConnectWide 创建此类接口，或在另一个调试器引擎客户端接口上调用 IUnknown：：QueryInterface 。

要求

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

另请参阅

客户端对象