Metodo IDebugSymbols3::GetNextSymbolMatch (dbgeng.h)

Articolo
02/06/2025

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 all'inizializzazione della ricerca.

[out, optional] Buffer

Riceve il nome del simbolo. Se buffer è null, lo stesso simbolo verrà restituito di nuovo alla 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 ha avuto esito positivo.
S_FALSE	La dimensione del buffer era troppo piccola per il nome del simbolo oppure buffer era NULL.
E_NOINTERFACE	Non sono stati trovati altri simboli corrispondenti al modello.

Osservazioni

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

Per altre informazioni sui simboli, vedere Simboli.