Función SymMatchFileName (dbghelp.h)
Compara una cadena con un nombre de archivo y una ruta de acceso.
Sintaxis
BOOL IMAGEAPI SymMatchFileName(
[in] PCSTR FileName,
[in] PCSTR Match,
[out, optional] PSTR *FileNameStop,
[out, optional] PSTR *MatchStop
);
Parámetros
[in] FileName
Nombre de archivo que se va a comparar con el parámetro Match .
[in] Match
Cadena que se va a comparar con el parámetro FileName .
[out, optional] FileNameStop
Puntero a un búfer de cadena que recibe un puntero a la ubicación de FileName donde se detiene la coincidencia. Para una coincidencia completa, este valor puede ser un carácter antes de FileName. Este valor también puede ser NULL.
[out, optional] MatchStop
Puntero a un búfer de cadena que recibe un puntero a la ubicación en Coincidencia donde se detiene la coincidencia. Para una coincidencia completa, este valor puede ser un carácter antes de Match. Este valor puede ser NULL.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es TRUE.
Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.
Comentarios
Dado que la cadena de coincidencia puede ser un sufijo del nombre de archivo completo, esta función se puede usar para hacer coincidir un nombre de archivo sin formato con un nombre de archivo completo.
La coincidencia comienza desde el final de ambas cadenas y continúa hacia atrás. La coincidencia no distingue mayúsculas de minúsculas y equivale a una barra diagonal inversa (\) con una barra diagonal (/).
Todas las funciones DbgHelp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.
Para llamar a la versión Unicode de esta función, defina DBGHELP_TRANSLATE_TCHAR.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | dbghelp.h |
| Library | Dbghelp.lib |
| Archivo DLL | Dbghelp.dll |
| Redistribuible | DbgHelp.dll 5.1 o posterior |