Metodo IDebugSymbols3::GetOffsetByName (dbgeng.h)
Il metodo GetOffsetByName restituisce la posizione di un simbolo identificato dal nome.
Sintassi
HRESULT GetOffsetByName(
[in] PCSTR Symbol,
[out] PULONG64 Offset
);
Parametri
[in] Symbol
Specifica il nome del simbolo da individuare. Il nome può essere qualificato da un nome di modulo, ad esempio mymodule!main).
[out] Offset
Riceve la posizione nello spazio indirizzi di memoria della destinazione della base dell'allocazione di memoria del simbolo.
Valore restituito
Questo metodo può anche restituire altri valori di errore. Per altri dettagli, vedere valori restituiti.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo ha avuto esito positivo. |
|
Il metodo ha avuto esito positivo. Tuttavia, il nome Simbolo non è univoco e sono stati trovati più simboli con tale nome. Uno di questi simboli è stato scelto arbitrariamente e restituito. |
|
Non è possibile trovare alcun simbolo con il nome specificato. |
Osservazioni
Se il nome Simbolo non è univoco e GetOffsetByName trova più simboli con tale nome, l'ambiguità verrà risolta in modo arbitrario. In questo caso, verrà restituito il valore S_FALSE. StartSymbolMatch può essere usato per avviare una ricerca per determinare quale è il risultato desiderato.
GetNameByOffset non supporta i criteri di ricerca (ad esempio caratteri jolly). Per trovare un simbolo usando criteri di ricerca, usare StartSymbolMatch.
Se il nome del modulo per il simbolo è noto, è preferibile qualificare il nome del simbolo con il nome del modulo. In caso contrario, il motore cercherà i simboli per tutti i moduli fino a quando non troverà una corrispondenza; questo può richiedere molto tempo se è necessario caricare i file di simboli per un sacco di moduli. Se il nome del simbolo è qualificato con un nome di modulo, il motore cerca solo i simboli per tale modulo.
Per altre informazioni sui simboli e sui nomi dei simboli, vedere Simboli.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | dbgeng.h (include Dbgeng.h) |