Método IDebugControl::GetExtensionFunction (dbgeng.h)
O método GetExtensionFunction retorna um ponteiro para uma função de extensão de uma biblioteca de extensão.
Sintaxe
HRESULT GetExtensionFunction(
[in] ULONG64 Handle,
[in] PCSTR FuncName,
[out] FARPROC *Function
);
Parâmetros
[in] Handle
Especifica o identificador da biblioteca de extensão que contém a função de extensão. Se Handle for zero, o mecanismo percorrerá a cadeia de bibliotecas de extensão 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 de depurador anexará "EFN" ao nome. Por exemplo, se FuncName for "SampleFunction", o mecanismo pesquisará as bibliotecas de extensão por "_EFN_SampleFunction".
[out] Function
Recebe a função de extensão.
Valor de retorno
Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
Observações
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 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) |