Metodo IDebugControl3::CallExtension (dbgeng.h)

Articolo
02/25/2024

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. Gli argomenti sono 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 è stato eseguito correttamente.

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

Commenti

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.