Compartilhar via


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

O método AddExtension carrega uma biblioteca de extensão no do mecanismo de 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 de retorno

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 de Valores Retornados para obter mais detalhes.

Observações

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

A biblioteca de extensão é 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 de extensão. Para disponibilizar a extensão para uso, faça uma chamada subsequente ao 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

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho dbgeng.h (inclua Dbgeng.h)

Consulte também

GetExtensionFunction.

GetExtensionByPath

IDebugControl

IDebugControl2

IDebugControl3

RemoveExtension