Funzione SymMatchFileNameW (dbghelp.h)
Confronta una stringa con un nome e un percorso di file.
Sintassi
BOOL IMAGEAPI SymMatchFileNameW(
[in] PCWSTR FileName,
[in] PCWSTR Match,
[out, optional] PWSTR *FileNameStop,
[out, optional] PWSTR *MatchStop
);
Parametri
[in] FileName
Nome del file da confrontare con il parametro
[in] Match
Stringa da confrontare con il parametro
[out, optional] FileNameStop
Puntatore a un buffer stringa che riceve un puntatore al percorso in FileName in cui la corrispondenza è stata arrestata. Per una corrispondenza completa, questo valore può essere un carattere prima di NomeFile. Questo valore può anche essere NULL.
[out, optional] MatchStop
Puntatore a un buffer di 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 non riesce, il valore restituito viene FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.
Osservazioni
Poiché la stringa di corrispondenza può essere un suffisso del nome file completo, questa funzione può essere usata per associare un nome di file normale a un nome di file completo.
La corrispondenza inizia dalla fine di entrambe le stringhe e procede all'indietro. La corrispondenza non fa distinzione tra maiuscole e minuscole ed equivale a una barra rovesciata (\) con una barra (/).
Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione genereranno probabilmente 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.
Nota
L'intestazione dbghelp.h definisce SymMatchFileName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| intestazione |
dbghelp.h |
| libreria |
Dbghelp.lib |
| dll | Dbghelp.dll |
| Ridistribuibile | DbgHelp.dll 5.1 o versione successiva |