Función DebugCreate (dbgeng.h)

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

Sintaxis

HRESULT DebugCreate(
  [in]  REFIID InterfaceId,
  [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 Interfaz. Para obtener información sobre el identificador de interfaz, vea Using Client Objects.

[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 información.

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

Observaciones

Los parámetros pasados a DebugCreate son los mismos que los pasados a IUnknown::QueryInterfacey se tratan de la misma manera.

Al igual que con IUnknown::QueryInterface, cuando ya no se necesita la interfaz devuelta, se debe llamar a su método IUnknown::Release.

No es necesario llamar a CoInitialize, CoInitializeExo OleInitialize para usar esta función e interfaces obtenidas por él.

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

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de dbgeng.h (include Dbgeng.h)

Consulte también

objetos de cliente