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

O método GetWindbgExtensionApis64 retorna uma estrutura que facilita o uso da API WdbgExts.

Sintaxe

HRESULT GetWindbgExtensionApis64(
  [in, out] PWINDBG_EXTENSION_APIS64 Api
);

Parâmetros

[in, out] Api

Recebe uma estrutura de WINDBG_EXTENSION_APIS64. Essa estrutura contém as funções usadas pela API WdbgExts. O nSize membro dessa estrutura deve ser definido como o tamanho da estrutura antes de ser passado para esse método.

Valor de retorno

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

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	O valor de API->nSize não é igual ao tamanho da estrutura WINDBG_EXTENSION_APIS64.

Observações

Se você estiver incluindo Wdbgexts.h em seu código de extensão, deverá chamar esse método durante a inicialização da DLL de extensão (consulte DebugExtensionInitialize).

Muitas funções WdbgExts são realmente macros. Para garantir que essas macros funcionem corretamente, a estrutura recebida pelo parâmetro da API deve ser armazenada em uma variável global chamada ExtensionApis.

A estrutura WINDBG_EXTENSION_APIS64 retornada por esse método serve à mesma finalidade que a fornecida para a função de retorno de chamada WinDbgExtensionDllInit (usada pelas extensões WdbgExts).

Para obter uma lista das funções fornecidas pela API WdbgExts, consulte WdbgExts Functions.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (incluem Wdbgexts.h, Dbgeng.h, Wdbgexts.h)