Metodo IDebugControl2::GetWindbgExtensionApis32 (dbgeng.h)

Articolo
02/23/2024

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

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.

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