Método IDebugControl::GetExtensionFunction (dbgeng.h)

Artigo
02/23/2024

O método GetExtensionFunction retorna um ponteiro para uma função de extensão de uma biblioteca de extensões.

Sintaxe

HRESULT GetExtensionFunction(
  [in]  ULONG64 Handle,
  [in]  PCSTR   FuncName,
  [out] FARPROC *Function
);

Parâmetros

[in] Handle

Especifica o identificador da biblioteca de extensões que contém a função de extensão. Se Handle for zero, o mecanismo percorrerá a cadeia de bibliotecas de extensões pesquisando a função de extensão.

[in] FuncName

Especifica o nome da função de extensão a ser retornada. Ao pesquisar as bibliotecas de extensão para a função, o mecanismo do depurador anexará "EFN" ao nome. Por exemplo, se FuncName for "SampleFunction", o mecanismo pesquisará "_EFN_SampleFunction" nas bibliotecas de extensão.

[out] Function

Recebe a função de extensão.

Retornar valor

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

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

Comentários

As bibliotecas de extensão são carregadas no mecanismo de host e as funções de extensão não podem ser chamadas remotamente. O cliente atual não deve ser um cliente de depuração, ele deve pertencer ao mecanismo de host.

A função de extensão pode ter qualquer protótipo de função. Para que qualquer programa chame essa função de extensão, a função de extensão deve ser convertida no protótipo correto.

Para obter mais informações sobre como usar funções de extensão, consulte Chamando extensões e funções de extensão.