Metodo IDebugSymbols3::GetNextSymbolMatchWide (dbgeng.h)

Articolo
02/25/2024

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

Sintassi

HRESULT GetNextSymbolMatchWide(
  [in]            ULONG64  Handle,
  [out, optional] PWSTR    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 successivamente quando uno di questi metodi viene chiamato (con lo stesso handle); questo può essere usato 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 altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Le dimensioni del buffer erano troppo piccole per il nome del simbolo o Buffer era NULL.
E_NOINTERFACE	Non sono stati trovati più 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 che il motore contiene per la ricerca.

Per altre informazioni sui simboli, vedere Simboli.