Metodo IDebugSymbols3::GetNearNameByOffset (dbgeng.h)

Articolo
02/06/2025

Il metodo GetNearNameByOffset restituisce il nome di un simbolo che si trova vicino alla posizione specificata.

Sintassi

HRESULT GetNearNameByOffset(
  [in]            ULONG64  Offset,
  [in]            LONG     Delta,
  [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 da cui viene determinato il simbolo desiderato.

[in] Delta

Specifica la relazione tra il simbolo desiderato e il simbolo che si trova in Offset. Se positivo, il motore restituirà il simbolo simboli delta dopo il simbolo posizionato in Offset. Se negativo, il motore restituirà il simbolo simboli delta prima del simbolo che si trova in corrispondenza di Offset.

[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 nello spazio indirizzi di memoria della destinazione 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 in modo da essere troncato.
E_NOINTERFACE	Non è stato trovato alcun simbolo corrispondente alle specifiche di Offset e Delta.

Osservazioni

Aumentando o riducendo il valore di Delta, questi metodi possono essere usati per scorrere i simboli della destinazione a partire da una determinata posizione.

Se delta è zero, questi metodi si comportano allo stesso modo di GetNameByOffset.

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