Metodo IDebugControl::GetExtensionFunction (dbgeng.h)

Articolo
02/25/2024

Il metodo GetExtensionFunction restituisce un puntatore a una funzione di estensione da una libreria di estensioni.

Sintassi

HRESULT GetExtensionFunction(
  [in]  ULONG64 Handle,
  [in]  PCSTR   FuncName,
  [out] FARPROC *Function
);

Parametri

[in] Handle

Specifica l'handle della libreria di estensioni che contiene la funzione di estensione. Se Handle è zero, il motore eseguirà la ricerca della catena di librerie di estensioni per la ricerca della funzione di estensione.

[in] FuncName

Specifica il nome della funzione di estensione da restituire. Durante la ricerca delle librerie di estensioni per la funzione, il motore del debugger anteporrà "EFN" al nome. Ad esempio, se FuncName è "SampleFunction", il motore cercherà le librerie di estensioni per "_EFN_SampleFunction".

[out] Function

Riceve la funzione di estensione.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

Le librerie di estensioni vengono caricate nel motore host e le funzioni di estensione non possono essere chiamate in remoto. Il client corrente non deve essere un client di debug, ma deve appartenere al motore host.

La funzione di estensione può avere qualsiasi prototipo di funzione. Affinché qualsiasi programma chiami questa funzione di estensione, è necessario eseguire il cast della funzione di estensione al prototipo corretto.

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