Compartir a través de

Función PathFindOnPathA (shlwapi.h)

  • Artículo

Busca un archivo.

Sintaxis

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

Parámetros

[in, out] pszPath

Tipo: LPTSTR

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 va a buscar primero. Este valor puede ser NULL.

Valor devuelto

Tipo: BOOL

Devuelve TRUE si es correcto o FALSE en caso contrario.

Comentarios

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 primero uno o varios directorios en los que se va a buscar. 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 Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 4.71 o posterior)