Função PathCompactPathExW (shlwapi.h)

Trunca um caminho para caber dentro de um determinado número de caracteres substituindo componentes de caminho por reticências.

Sintaxe

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

Parâmetros

[out] pszOut

Tipo: LPTSTR

O endereço da cadeia de caracteres que foi alterada.

[in] pszSrc

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres de comprimento terminada em nulo MAX_PATH que contém o caminho a ser alterado.

[in] cchMax

Tipo: UINT

O número máximo de caracteres a serem contidos na nova cadeia de caracteres, incluindo o caractere nulo de encerramento. Por exemplo, se cchMax = 8, a cadeia de caracteres resultante poderá conter um máximo de 7 caracteres mais o caractere nulo de terminação.

[in] dwFlags

Tipo: DWORD

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

O separador '/' será usado em vez de '\' se a cadeia de caracteres original o tiver usado. Se pszSrc apontar para um nome de arquivo muito longo, em vez de um caminho, o nome do arquivo será truncado para caracteres de cchMax, incluindo as reticências e o caractere de NULL terminação. Por exemplo, se o nome do arquivo de entrada for "My Filename" e cchMax for 10, PathCompactPathEx retornará "My Fil...".

Requisitos