Metodo IDebugControl3::GetWindbgExtensionApis32 (dbgeng.h)

Articolo
02/06/2025

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

Sintassi

HRESULT GetWindbgExtensionApis32(
  [in, out] PWINDBG_EXTENSION_APIS32 Api
);

Parametri

[in, out] Api

Riceve una struttura WINDBG_EXTENSION_APIS32. Questa struttura contiene le funzioni usate dall'API WdbgExts. Il membro nSize di questa struttura deve essere impostato sulle dimensioni della struttura prima che venga passato a questo metodo.

Valore restituito

Questo metodo può anche restituire altri valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
E_INVALIDARG	Il valore di Api->nSize non è uguale alla dimensione della struttura WINDBG_EXTENSION_APIS32.

Osservazioni

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

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

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