Metodo IDebugControl2::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 contenente l'estensione da chiamare. Se Handle è zero, il motore eseguirà la ricerca della catena di librerie di estensioni per la ricerca dell'estensione.

[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 altre informazioni, vedere Valori restituiti .

Commenti

Se Handle è zero, il motore cerca ogni libreria di estensioni finché non trova una 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 Chiamate di estensioni e funzioni di estensione.