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 desejado. Esse é o tipo da interface que será retornada em Interface. Para obter informações sobre o identificador de interface, consulte Usando objetos 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.

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 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, 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

Funções do cliente

objetos cliente