Metodo IDebugSymbols3::StartSymbolMatch (dbgeng.h)

Articolo
02/23/2024

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

Sintassi

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

Parametri

[in] Pattern

Specifica il modello per cui 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 corrispondenza 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 altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_NOINTERFACE	Il modulo specificato non è stato trovato.

Commenti

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 che il motore contiene per la ricerca.

Per altre informazioni sui simboli, vedere Simboli.