Función DebugCreate (dbgeng.h)
La función DebugCreate crea un nuevo objeto de cliente y devuelve un puntero de interfaz a él.
HRESULT DebugCreate(
[in] REFIID InterfaceId,
[out] PVOID *Interface
);
[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 interfaz, vea Using Client Objects.
[out] Interface
Recibe un puntero de interfaz para el nuevo cliente. InterfaceId especifica el tipo de esta interfaz.
Este método también puede devolver otros valores de error. Consulte Valores devueltos para obtener más detalles.
Código devuelto | Descripción |
---|---|
|
La función se realizó correctamente. |
|
El objeto de cliente no implementa la interfaz especificada. |
Los parámetros pasados a DebugCreate 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 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.
Requisito | Value |
---|---|
Plataforma de destino | Escritorio |
Encabezado | dbgeng.h (include Dbgeng.h) |