Metodo IDebugSymbols3::StartSymbolMatch (dbgeng.h)

Articolo
02/06/2025

Il metodo StartSymbolMatch inizializza una ricerca di simboli i cui nomi corrispondono a un determinato criterio.

Sintassi

HRESULT StartSymbolMatch(
  [in]  PCSTR    Pattern,
  [out] PULONG64 Handle
);

Parametri

[in] Pattern

Specifica il criterio per il quale eseguire la ricerca. La ricerca restituirà tutti i simboli i cui nomi corrispondono a questo modello. Per informazioni dettagliate sulla sintassi del modello, vedere sintassi dei simboli e di corrispondenza dei simboli e sintassi con caratteri jolly stringa.

[out] Handle

Riceve l'handle che identifica la ricerca. Questo handle può essere passato a GetNextSymbolMatch e EndSymbolMatch.

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.
E_NOINTERFACE	Il modulo specificato non è stato trovato.

Osservazioni

Questo metodo inizializza una ricerca di simboli. I risultati della ricerca possono essere ottenuti tramite chiamate ripetute a GetNextSymbolMatch. Quando sono stati trovati tutti i risultati desiderati, usare EndSymbolMatch per rilasciare le risorse contenute nel motore per la ricerca.

Per altre informazioni sui simboli, vedere Simboli.