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

Artigo
02/23/2024

O método CallExtension chama uma extensão de depurador.

Sintaxe

HRESULT CallExtension(
  [in]           ULONG64 Handle,
  [in]           PCSTR   Function,
  [in, optional] PCSTR   Arguments
);

Parâmetros

[in] Handle

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

[in] Function

Especifica o nome da extensão a ser chamada.

[in, optional] Arguments

Especifica os argumentos a serem passados para a extensão. Os argumentos são uma cadeia de caracteres que será analisada pela extensão, assim como a extensão analisará os argumentos passados para ela quando chamado como um comando de extensão.

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 Handle for zero, o mecanismo pesquisará cada biblioteca de extensões até encontrar uma que contenha a extensão; em seguida, a extensão será chamada. Se a extensão retornar DEBUG_EXTENSION_CONTINUE_SEARCH, a pesquisa continuará.

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