Função DebugCreateEx (dbgeng.h)

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

Sintaxe

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

Parâmetros

[in] InterfaceId

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

[in] DbgEngOptions

Fornece sinalizadores de opção de depurador.

[out] Interface

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

Retornar valor

Esse método também pode retornar outros valores de erro. Consulte 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.

Comentários

Os parâmetros passados para DebugCreateEx 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, CoInitializeEx ou 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, CoCreateInstanceEx ou CoGetClassObject. Use DebugCreate, DebugCreateEx, DebugConnect ou DebugConnectWide para criar essa interface ou chame IUnknown::QueryInterface em outra interface do cliente do mecanismo de depurador.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	dbgeng.h (inclua Dbgeng.h)

Confira também

Funções do cliente

Objetos do cliente