Metodo IDebugSymbols::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 rappresenta 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 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 in modo che sia stato troncato.
E_NOINTERFACE	Non è stato trovato alcun simbolo corrispondente alle specifiche di Offset e Delta .

Commenti

Aumentando o diminuendo 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.