Metodo IDebugSymbols3::GetNearNameByOffset (dbgeng.h)

Articolo
02/23/2024

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 delta dopo il simbolo che si trova in Offset. Se negativo, il motore restituirà il simbolo che è i simboli Delta prima del simbolo che si trova in 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 degli indirizzi di memoria della destinazione del simbolo. Se lo spostamento è NULL, queste informazioni non vengono restituite.

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 buffer non era abbastanza grande per contenere il nome del simbolo in modo che fosse troncato.
E_NOINTERFACE	Non è stato trovato alcun simbolo corrispondente alle specifiche di Offset e Delta .

Commenti

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

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

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