Metodo IDebugSymbols::GetOffsetByName (dbgeng.h)

Articolo
02/23/2024

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
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, il nome Symbol non è univoco e sono stati trovati più simboli con tale nome. Uno di questi simboli è stato scelto arbitrariamente e restituito.
E_FAIL	Non è possibile trovare alcun simbolo con il nome specificato.

Commenti

Se il nome Symbol 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 i 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.