Função PathCompactPathExW (shlwapi.h)
Trunca um caminho para caber em 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 terminada em nulo de comprimento 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 terminação. 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
Retornar valor
Tipo: BOOL
Retornará TRUE se tiver êxito ou FALSE caso contrário.
Comentários
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 cchMax , incluindo as reticências e o caractere NULL de terminação. Por exemplo, se o nome do arquivo de entrada for "My Filename" e cchMax for 10, PathCompactPathEx retornará "My Fil...".
Observação
O cabeçalho shlwapi.h define PathCompactPathEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | shlwapi.h |
Biblioteca | Shlwapi.lib |
DLL | Shlwapi.dll (versão 4.71 ou posterior) |