Función PathFindOnPathA (shlwapi.h)

Busca un archivo.

Sintaxis

BOOL PathFindOnPathA(
  [in, out]      LPSTR   pszPath,
  [in, optional] PZPCSTR ppszOtherDirs
);

Parámetros

[in, out] pszPath

Tipo: LPTSTR de

Puntero a una cadena terminada en null de longitud MAX_PATH que contiene el nombre de archivo para el que se va a buscar. Si la búsqueda se realiza correctamente, este parámetro se usa para devolver el nombre de ruta de acceso completo.

[in, optional] ppszOtherDirs

Tipo: LPCTSTR*

Matriz opcional terminada en null de directorios que se buscarán primero. Este valor puede ser null.

Valor devuelto

Tipo: BOOL de

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario.

Observaciones

PathFindOnPath busca el archivo especificado por pszFile. Si no se especifica ningún directorio en ppszOtherDirs, intenta buscar el archivo buscando directorios estándar como System32 y los directorios especificados en la variable de entorno PATH. Para acelerar el proceso o habilitar PathFindOnPath para buscar en una gama más amplia de directorios, use el parámetro ppszOtherDirs para especificar uno o varios directorios en los que se va a buscar primero. Si más de un archivo tiene el nombre especificado por pszFile, PathFindOnPath devuelve la primera instancia que encuentra.

Nota

El encabezado shlwapi.h define PathFindOnPath como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 4.71 o posterior)