Metodo IDebugControl3::GetWindbgExtensionApis64 (dbgeng.h)
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 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 |
|---|---|
|
Il metodo ha avuto esito positivo. |
|
Il valore di Api->nSize non è uguale alla dimensione della struttura WINDBG_EXTENSION_APIS64. |
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.
La struttura WINDBG_EXTENSION_APIS64 restituita da questo metodo ha lo stesso scopo di quello fornito alla funzione di callback WinDbgExtensionDllInit (usato dalle estensioni WdbgExts).
Per un elenco delle funzioni fornite dall'API WdbgExts, vedere funzioni WdbgExts.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | dbgeng.h (include Wdbgexts.h, Dbgeng.h, Wdbgexts.h) |