Funzione SymMatchFileName (dbghelp.h)

  • Articolo

Confronta una stringa con un nome e un percorso di file.

Sintassi

BOOL IMAGEAPI SymMatchFileName(
  [in]            PCSTR FileName,
  [in]            PCSTR Match,
  [out, optional] PSTR  *FileNameStop,
  [out, optional] PSTR  *MatchStop
);

Parametri

[in] FileName

Nome file da confrontare con il parametro Match .

[in] Match

Stringa da confrontare con il parametro FileName .

[out, optional] FileNameStop

Puntatore a un buffer di stringa che riceve un puntatore alla posizione in FileName in cui la corrispondenza viene arrestata. Per una corrispondenza completa, questo valore può essere un carattere prima di FileName. Questo valore può anche essere NULL.

[out, optional] MatchStop

Puntatore a un buffer stringa che riceve un puntatore alla posizione in Corrispondenza in cui la corrispondenza è stata arrestata. Per una corrispondenza completa, questo valore può essere un carattere prima di Match. Questo valore può essere NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

Poiché la stringa di corrispondenza può essere un suffisso del nome file completo, questa funzione può essere usata per corrispondere a un nome file normale a un nome file completo.

La corrispondenza inizia dalla fine di entrambe le stringhe e procede all'indietro. La corrispondenza è senza distinzione tra maiuscole e minuscole e equivale a una barra rovesciata (\) con una barra in avanti (/).

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione potrebbero causare un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.

Per chiamare la versione Unicode di questa funzione, definire DBGHELP_TRANSLATE_TCHAR.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione dbghelp.h
Libreria Dbghelp.lib
DLL Dbghelp.dll
Componente ridistribuibile DbgHelp.dll 5.1 o versioni successive

Vedi anche

Funzioni DbgHelp