Partilhar via


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

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 bibliotecas de extensão 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. Arguments é 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.

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 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 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

AddExtension

GetExtensionByPath

GetExtensionFunction

IDebugControl

IDebugControl2

IDebugControl3