Método IDebugControl3::AddExtension (dbgeng.h)

O método AddExtension carrega uma biblioteca de extensões no mecanismo do depurador.

Sintaxe

HRESULT AddExtension(
  [in]  PCSTR    Path,
  [in]  ULONG    Flags,
  [out] PULONG64 Handle
);

Parâmetros

[in] Path

Especifica o caminho totalmente qualificado e o nome do arquivo da biblioteca de extensão a ser carregada.

[in] Flags

Definido como zero.

[out] Handle

Recebe o identificador da biblioteca de extensão carregada.

Valor retornado

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
 

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

Comentários

Se a biblioteca de extensão já tiver sido carregada, o identificador para a biblioteca já carregada será retornado. A biblioteca de extensões não é carregada novamente.

A biblioteca de extensões é carregada no mecanismo de host e o Caminho contém um caminho e um nome de arquivo para essa instância do mecanismo de depurador.

AddExtension não conclui o processo de carregamento e inicialização da DLL de extensão. Para disponibilizar a extensão para uso, faça uma chamada subsequente para GetExtensionFunction.

Para obter mais informações sobre como usar bibliotecas de extensão, consulte Extensões de Chamada e Funções de Extensão.

Requisitos

   
Plataforma de Destino Desktop
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

GetExtensionFunction.

GetExtensionByPath

Idebugcontrol

IDebugControl2

IDebugControl3

RemoveExtension