The DebugCreate function creates a new client object and returns an interface pointer to it.

HRESULT
  DebugCreate(
    IN REFIID  InterfaceId,
    OUT PVOID *  Interface
    );

Parameters

InterfaceId

Specifies the interface identifier (IID) of the desired debugger engine client interface. This is the type of the interface that will be returned in Interface. For information about the interface identifier, see COM Interfaces.

Interface

Receives an interface pointer for the new client. The type of this interface is specified by InterfaceId.

Return Value

S_OK

The function was successful.

E_NOINTERFACE

The client object doesn't implement the specified interface.

This method may also return other error values. See Return Values for more details.

Comments

The parameters passed to DebugCreate are the same as those passed to IUnknown::QueryInterface, and they are treated the same way.

As with IUnknown::QueryInterface, when the returned interface is no longer needed, its IUnknown::Release method should be called.

Requirements

Headers: Defined in dbgeng.h. Include dbgeng.h.

See Also

Client Objects