DebugCreate 函数 (dbgeng.h)
DebugCreate 函数创建新的客户端对象,并返回指向它的接口指针。
语法
HRESULT DebugCreate(
[in] REFIID InterfaceId,
[out] PVOID *Interface
);
参数
[in] InterfaceId
指定所需调试器引擎客户端接口 (IID) 接口标识符。 这是将在接口中返回的 接口的类型。 有关接口标识符的信息,请参阅 使用客户端对象。
[out] Interface
接收新客户端的接口指针。 此接口的类型由 InterfaceId 指定。
返回值
此方法也可能返回其他错误值。 有关更多详细信息 ,请参阅返回值 。
返回代码 | 说明 |
---|---|
|
函数成功。 |
|
客户端对象不实现指定的接口。 |
注解
传递给 DebugCreate 的参数 与传递给 IUnknown::QueryInterface 的参数相同,并且以相同的方式处理它们。
与 IUnknown::QueryInterface 一样,当不再需要返回的接口时,应调用其 IUnknown::Release 方法。
无需调用 CoInitialize、 CoInitializeEx 或 OleInitialize 即可使用此函数及其获取的接口。
无法通过调用 CoCreateInstance、CoCreateInstanceEx 或 CoGetClassObject 来获取调试器引擎客户端接口。 使用 DebugCreate、 DebugCreateEx、 DebugConnect 或 DebugConnectWide 创建此类接口,或在另一个调试器引擎客户端接口上调用 IUnknown::QueryInterface 。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |