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

Artigo
02/23/2024

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.