Metodo IDebugSymbols3::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 del modulo (ad esempio , mymodule!main).

[out] Offset

Riceve la posizione nello spazio degli indirizzi di memoria della destinazione della base dell'allocazione della memoria del simbolo.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, il nome Simbolo non era univoco e più simboli con tale nome sono stati trovati. 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 arbitrariamente. In questo caso, il valore S_FALSE verrà restituito. StartSymbolMatch può essere usato per avviare una ricerca per determinare quale è il risultato desiderato.

GetNameByOffset non supporta la corrispondenza dei modelli (ad esempio i caratteri jolly). Per trovare un simbolo usando la corrispondenza dei modelli, usare StartSymbolMatch.

Se il nome del modulo per il simbolo è noto, è consigliabile qualificare il nome del simbolo con il nome del modulo. In caso contrario, il motore cerca i simboli per tutti i moduli finché non trova una corrispondenza; ciò può richiedere molto tempo se deve caricare i file di simboli per un sacco di moduli. Se il nome del simbolo è qualificato con un nome del modulo, il motore cerca solo i simboli per tale modulo.

Per altre informazioni sui simboli e sui nomi dei simboli, vedere Simboli.