Metodo IDebugSymbols3::GetNextSymbolMatch (dbgeng.h)

Articolo
02/25/2024

Il metodo GetNextSymbolMatch restituisce il simbolo successivo trovato in una ricerca di simboli.

Sintassi

HRESULT GetNextSymbolMatch(
  [in]            ULONG64  Handle,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   MatchSize,
  [out, optional] PULONG64 Offset
);

Parametri

[in] Handle

Specifica l'handle restituito da StartSymbolMatch quando la ricerca è stata inizializzata.

[out, optional] Buffer

Riceve il nome del simbolo. Se Buffer è NULL, lo stesso simbolo verrà restituito di nuovo alla successiva chiamata di uno di questi metodi (con lo stesso handle); può essere utilizzato per determinare le dimensioni del nome del simbolo.

[in] BufferSize

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

[out, optional] MatchSize

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

[out, optional] Offset

Riceve la posizione nello spazio indirizzi virtuale della destinazione del simbolo. Se Offset è 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	La dimensione del buffer era troppo piccola per il nome del simbolo o Buffer era NULL.
E_NOINTERFACE	Non sono stati trovati altri simboli corrispondenti al modello.

Commenti

La ricerca deve prima essere inizializzata da StartSymbolMatch. Dopo aver trovato tutti i simboli desiderati, EndSymbolMatch può essere usato per rilasciare le risorse contenute nel motore per la ricerca.

Per altre informazioni sui simboli, vedere Simboli.