Metodo IDebugSymbols3::GetNameByOffset (dbgeng.h)

Articolo
02/06/2025

Il metodo GetNameByOffset restituisce il nome del simbolo nella posizione specificata nello spazio indirizzi virtuale della destinazione.

Sintassi

HRESULT GetNameByOffset(
  [in]            ULONG64  Offset,
  [out, optional] PSTR     NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Displacement
);

Parametri

[in] Offset

Specifica la posizione nello spazio indirizzi virtuale della destinazione del simbolo il cui nome è richiesto. offset non è necessario specificare la posizione di base del simbolo; deve specificare solo una posizione all'interno dell'allocazione di memoria del simbolo.

[out, optional] NameBuffer

Riceve il nome del simbolo. Il nome è qualificato dal modulo a cui appartiene il simbolo, ad esempio mymodule!main). Se NameBuffer è null, queste informazioni non vengono restituite.

[in] NameBufferSize

Specifica le dimensioni in caratteri del buffer NameBuffer. Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] NameSize

Riceve le dimensioni in caratteri del nome del simbolo. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se NameSize è null, queste informazioni non vengono restituite.

[out, optional] Displacement

Riceve la differenza tra il valore di offset e la posizione di base del simbolo. Se di spostamento è NULL, queste informazioni non vengono restituite.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
S_FALSE	Il metodo ha avuto esito positivo. Tuttavia, il buffer non era abbastanza grande da contenere il nome del simbolo, quindi è stato troncato.
E_FAIL	Non è stato possibile trovare alcun simbolo nella posizione specificata.