Metodo IDebugControl2::GetWindbgExtensionApis64 (dbgeng.h)

  • Articolo

Il metodo GetWindbgExtensionApis64 restituisce una struttura che facilita l'uso dell'API WdbgExts.

Sintassi

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

Parametri

[in, out] Api

Riceve una struttura WINDBG_EXTENSION_APIS64. Questa struttura contiene le funzioni usate dall'API WdbgExts. Il membro nSize di questa struttura deve essere impostato sulla dimensione della struttura prima che venga passata a questo metodo.

Valore restituito

Questo metodo può anche restituire altri valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito Descrizione
S_OK
 Il metodo è stato eseguito correttamente.
E_INVALIDARG
 Il valore di Api->nSize non equivale alla dimensione della struttura WINDBG_EXTENSION_APIS64.

Commenti

Se si include Wdbgexts.h nel codice di estensione, è necessario chiamare questo metodo durante l'inizializzazione della DLL dell'estensione (vedere DebugExtensionInitialize).

Molte funzioni WdbgExts sono davvero macro. Per assicurarsi che queste macro funzionino correttamente, la struttura ricevuta dal parametro Api deve essere archiviata in una variabile globale denominata ExtensionApis.

La struttura WINDBG_EXTENSION_APIS64 restituita da questo metodo serve lo stesso scopo fornito alla funzione di callback WinDbgExtensionDllInit (utilizzata dalle estensioni WdbgExts).

Per un elenco delle funzioni fornite dall'API WdbgExts, vedere Funzioni WdbgExts.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione dbgeng.h (include Wdbgexts.h, Dbgeng.h, Wdbgexts.h)