PDEBUG_EXTENSION_CALL função de retorno de chamada (dbgeng.h)
As funções de retorno de chamada do tipo PDEBUG_EXTENSION_CALL são chamadas pelo mecanismo para executar comandos de extensão. Você pode dar a essas funções qualquer nome desejado, desde que ela não contenha letras maiúsculas.
Sintaxe
PDEBUG_EXTENSION_CALL PdebugExtensionCall;
HRESULT PdebugExtensionCall(
[in] PDEBUG_CLIENT Client,
[in, optional] PCSTR Args
)
{...}
Parâmetros
[in] Client
Especifica um ponteiro de interface para o cliente. Isso pode ser usado para interagir com o mecanismo. Normalmente, esse é o cliente por meio do qual o comando de extensão foi emitido.
[in, optional] Args
Especifica os argumentos passados para o comando de extensão. Em particular, se o comando de extensão foi chamado de uma linha de comando, Args contém o restante da linha de comando. Pode ser NULL ou vazio.
Retornar valor
| Código de retorno | Descrição |
|---|---|
|
A função foi bem-sucedida. |
|
Indica que a função não pode manipular o comando ou que outras implementações do mesmo comando em outras DLLs de extensão também devem ser executadas. O mecanismo deve continuar pesquisando outras DLLs de extensão por outra função para manipular o comando. Por exemplo, isso pode ser usado para que todas as funções de ajuda sejam executadas se cada uma retornar CONTINUE_SEARCH. |
Todos os outros valores retornados são ignorados pelo mecanismo.
Comentários
O nome da função se torna o nome do comando de extensão. Ao executar um comando de extensão, o mecanismo pesquisa por cada uma das DLLs de extensão carregadas, procurando uma função exportada que tenha o mesmo nome que o comando. Por exemplo, ao executar o comando !stack, o mecanismo procurará uma função exportada chamada stack em cada DLL de extensão carregada. Para obter informações sobre a ordem na qual as DLLs de extensão são pesquisadas, consulte Usando comandos de extensão do depurador.
A função de extensão deve usar o cliente que foi passado para ele no Cliente para toda a interação com o mecanismo, a menos que tenha um motivo específico para usar outro cliente. A função de extensão não deve manter o ponteiro para o objeto cliente após a conclusão.
DebugExtensionCall é chamado PDEBUG_EXTENSION_CALL no arquivo de cabeçalho Dbgeng.h.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | dbgeng.h |