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

Consulte también

Funciones de DbgHelp