Compartilhar via


Método IDebugControl::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

Defina como zero.

[out] Handle

Recebe o identificador da biblioteca de extensão carregada.

Retornar valor

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 Path contém um caminho e um nome de arquivo para esta instância do mecanismo de depurador.

AddExtension não conclui o processo de carregamento e inicialização da DLL da 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 Chamando extensões e funções de extensão.

Requisitos

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

Confira também

GetExtensionFunction

GetExtensionByPath

RemoveExtension

Idebugcontrol

IDebugControl2

IDebugControl3