Metodo IDebugControl3::CallExtension (dbgeng.h)

Articolo
02/06/2025

Il metodo CallExtension chiama un'estensione del debugger.

Sintassi

HRESULT CallExtension(
  [in]           ULONG64 Handle,
  [in]           PCSTR   Function,
  [in, optional] PCSTR   Arguments
);

Parametri

[in] Handle

Specifica l'handle della libreria di estensioni che contiene l'estensione da chiamare. Se handle è zero, il motore eseguirà la ricerca dell'estensione nella catena di librerie di estensioni.

[in] Function

Specifica il nome dell'estensione da chiamare.

[in, optional] Arguments

Specifica gli argomenti da passare all'estensione. Arguments è una stringa che verrà analizzata dall'estensione, proprio come l'estensione analizzerà gli argomenti passati quando viene chiamato come comando di estensione.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

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

Osservazioni

Se Handle è zero, il motore cerca ogni libreria di estensioni finché non ne trova uno che contiene l'estensione; l'estensione verrà quindi chiamata. Se l'estensione restituisce DEBUG_EXTENSION_CONTINUE_SEARCH, la ricerca continuerà.

Per altre informazioni sull'uso delle librerie di estensioni, vedere Chiamata di estensioni e funzioni di estensione.