Compartir a través de

Función PathResolve (shlobj_core.h)

  • Artículo

[PathResolve está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Convierte un nombre de ruta de acceso relativo o no completo en un nombre de ruta de acceso completo.

Sintaxis

int PathResolve(
  [in, out]      PWSTR    pszPath,
  [in, optional] PZPCWSTR dirs,
                 UINT     fFlags
);

Parámetros

[in, out] pszPath

Tipo: PWSTR

Cadena Unicode terminada en null que contiene la ruta de acceso que se va a resolver. Cuando se devuelve la función, la cadena contiene la ruta de acceso completa correspondiente. Este búfer debe tener al menos MAX_PATH caracteres.

[in, optional] dirs

Tipo: PZPCWSTR

Puntero a una matriz opcional terminada en null de directorios que se va a buscar primero en el caso de que la ruta de acceso no se pueda resolver desde pszPath. Este valor puede ser NULL.

fFlags

Tipo: UINT

Marcas que especifican cómo funciona la función.

PRF_VERIFYEXISTS

Devuelve TRUE si se comprueba la existencia del archivo; en caso contrario , FALSE.

PRF_TRYPROGRAMEXTENSIONS

Busque la ruta de acceso especificada con las siguientes extensiones anexadas: .pif, .com, .bat, .cmd, .lnk y .exe.

PRF_FIRSTDIRDEF

Busque primero en el directorio o directorios especificados por dirs.

PRF_DONTFINDLNK

Omita los archivos .lnk.

PRF_REQUIREABSOLUTE

Requerir una ruta de acceso absoluta (completa).

Valor devuelto

Tipo: int

Devuelve TRUE, a menos que se establezca PRF_VERIFYEXISTS. Si se establece esa marca, la función devuelve TRUE si se comprueba que el archivo existe y FALSE en caso contrario. También establece un código de error ERROR_FILE_NOT_FOUND que puede recuperar llamando a GetLastError.

Comentarios

Un valor devuelto FALSE no significa necesariamente que el archivo no exista. Puede significar que la función simplemente no puede encontrar el archivo de la información proporcionada.

Si PathResolve no puede resolver la ruta de acceso especificada en pszPath, llama a PathFindOnPath mediante pszPath y dirs como parámetros.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)
Conjunto de API ext-ms-win-shell-shell32-l1-2-2 (introducido en Windows 10, versión 10.0.14393)

Consulte también

PathFindOnPath