Compartir a través de

Función PathCompactPathExW (shlwapi.h)

  • Artículo

Trunca una ruta de acceso para ajustarse a un determinado número de caracteres reemplazando los componentes de ruta de acceso por puntos suspensivos.

Sintaxis

BOOL PathCompactPathExW(
  [out] LPWSTR  pszOut,
  [in]  LPCWSTR pszSrc,
  [in]  UINT    cchMax,
  [in]  DWORD   dwFlags
);

Parámetros

[out] pszOut

Tipo: LPTSTR de

Dirección de la cadena que se ha modificado.

[in] pszSrc

Tipo: LPCTSTR de

Puntero a una cadena terminada en null de longitud MAX_PATH que contiene la ruta de acceso que se va a modificar.

[in] cchMax

Tipo: UINT

Número máximo de caracteres que se incluirán en la nueva cadena, incluido el carácter NULO de terminación. Por ejemplo, si cchMax = 8, la cadena resultante puede contener un máximo de 7 caracteres más el carácter nulo de terminación.

[in] dwFlags

Tipo: DWORD de

Valor devuelto

Tipo: BOOL de

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

Observaciones

El separador '/' se usará en lugar de '\' si la cadena original la usó. Si pszSrc apunta a un nombre de archivo que es demasiado largo, en lugar de una ruta de acceso, el nombre de archivo se truncará en caracteres cchMax, incluidos los puntos suspensivos y el carácter de NULL. Por ejemplo, si el nombre del archivo de entrada es "Mi nombre de archivo" y cchMax es 10, PathCompactPathEx devolverá "My Fil...".

Nota

El encabezado shlwapi.h define PathCompactPathEx 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)