Función DebugCreateEx (dbgeng.h)

La función DebugCreateEx crea un nuevo objeto de cliente y devuelve un puntero de interfaz a él.

Sintaxis

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

Parámetros

[in] InterfaceId

Especifica el identificador de interfaz (IID) de la interfaz de cliente del motor de depurador deseado. Este es el tipo de la interfaz que se devolverá en Interface. Para obtener información sobre el identificador de la interfaz, vea Uso de objetos de cliente.

[in] DbgEngOptions

Proporciona marcas de opción del depurador.

[out] Interface

Recibe un puntero de interfaz para el nuevo cliente. El tipo de esta interfaz se especifica mediante InterfaceId.

Valor devuelto

Este método también puede devolver otros valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	La función se realizó correctamente.
E_NOINTERFACE	El objeto de cliente no implementa la interfaz especificada.

Comentarios

Los parámetros pasados a DebugCreateEx son los mismos que los que se pasan a IUnknown::QueryInterface y se tratan de la misma manera.

Al igual que con IUnknown::QueryInterface, cuando la interfaz devuelta ya no es necesaria, se debe llamar al método IUnknown::Release .

No es necesario llamar a CoInitialize, CoInitializeEx ni OleInitialize para usar esta función e interfaces obtenidas por ella.

Las interfaces de cliente del motor de depurador no se pueden obtener llamando a CoCreateInstance, CoCreateInstanceEx o CoGetClassObject. Use DebugCreate, DebugCreateEx, DebugConnect o DebugConnectWide para crear dicha interfaz, o llame a IUnknown::QueryInterface en otra interfaz de cliente del motor de depurador.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	dbgeng.h (incluir Dbgeng.h)

Consulte también

Funciones de cliente

Objetos de cliente