Funzione SymMatchFileName (dbghelp.h)
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 |