Metodo IDebugControl::AddExtension (dbgeng.h)

Articolo
02/25/2024

Il metodo AddExtension carica una libreria di estensioni nel motore del debugger.

Sintassi

HRESULT AddExtension(
  [in]  PCSTR    Path,
  [in]  ULONG    Flags,
  [out] PULONG64 Handle
);

Parametri

[in] Path

Specifica il percorso completo e il nome file della libreria di estensioni da caricare.

[in] Flags

Imposta su zero.

[out] Handle

Riceve l'handle della libreria di estensioni caricata.

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 la libreria di estensione è già stata caricata, viene restituito l'handle per la libreria già caricata. La libreria di estensioni non viene caricata di nuovo.

La libreria di estensioni viene caricata nel motore host e Path contiene un percorso e un nome di file per questa istanza del motore del debugger.

AddExtension non completa il processo di caricamento e inizializzazione della DLL dell'estensione. Per rendere disponibile l'estensione per l'uso, effettuare una chiamata successiva a GetExtensionFunction.

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