Metodo IDebugSymbols3::GetNameByOffset (dbgeng.h)

Articolo
02/25/2024

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. L'offset non deve 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 Lo 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 è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, il buffer non era sufficientemente grande da contenere il nome del simbolo, quindi è stato troncato.
E_FAIL	Non è possibile trovare alcun simbolo nella posizione specificata.