Função DebugCreate (dbgeng.h)

A função DebugCreate cria um novo objeto cliente e retorna um ponteiro de interface para ele.

Sintaxe

HRESULT DebugCreate(
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

Parâmetros

[in] InterfaceId

Especifica o IID (identificador de interface) da interface do cliente do mecanismo de depurador desejado. Esse é o tipo da interface que será retornada em Interface. Para obter informações sobre o identificador de interface, consulte Usando objetos cliente.

[out] Interface

Recebe um ponteiro de interface para o novo cliente. O tipo dessa interface é especificado por InterfaceId.

Valor de retorno

Esse método também pode retornar outros valores de erro. Consulte de Valores Retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	A função foi bem-sucedida.
E_NOINTERFACE	O objeto cliente não implementa a interface especificada.

Observações

Os parâmetros passados para DebugCreate são os mesmos passados para IUnknown::QueryInterface e são tratados da mesma maneira.

Assim como acontece com IUnknown::QueryInterface, quando a interface retornada não é mais necessária, seu método IUnknown::Release deve ser chamado.

Você não precisa chamar CoInitialize, CoInitializeExou OleInitialize para usar essa função e interfaces obtidas por ela.

As interfaces do cliente do mecanismo de depurador não podem ser obtidas chamando CoCreateInstance, CoCreateInstanceExou CoGetClassObject. Use DebugCreate, DebugCreateEx, DebugConnectou DebugConnectWide para criar tal interface ou chamar IUnknown::QueryInterface em outra interface do cliente do mecanismo de depurador.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

objetos cliente