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