Share via

Функция 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)

См. также раздел

Клиентские объекты