Funzione PathCompactPathExA (shlwapi.h)

Tronca un percorso per adattarsi a un determinato numero di caratteri sostituendo i componenti di percorso con puntini di sospensione.

Sintassi

BOOL PathCompactPathExA(
  [out] LPSTR  pszOut,
  [in]  LPCSTR pszSrc,
  [in]  UINT   cchMax,
  [in]  DWORD  dwFlags
);

Parametri

[out] pszOut

Tipo: LPTSTR

Indirizzo della stringa modificata.

[in] pszSrc

Tipo: LPCTSTR

Puntatore a una stringa di lunghezza con terminazione Null MAX_PATH che contiene il percorso da modificare.

[in] cchMax

Tipo: UINT

Numero massimo di caratteri da includere nella nuova stringa, incluso il carattere Null di terminazione. Ad esempio, se cchMax = 8, la stringa risultante può contenere un massimo di 7 caratteri più il carattere null di terminazione.

[in] dwFlags

Tipo: DWORD

Valore restituito

Tipo: BOOL

Restituisce TRUE se l'operazione riesce o FALSE in caso contrario.

Commenti

Il separatore '/' verrà usato invece di '' se la stringa originale la utilizzava. Se pszSrc punta a un nome di file troppo lungo, anziché un percorso, il nome del file verrà troncato a caratteri cchMax , inclusi i puntini di sospensione e il carattere NULL di terminazione. Ad esempio, se il nome del file di input è "My Filename" e cchMax è 10, PathCompactPathEx restituirà "My Fil...".

Nota

L'intestazione shlwapi.h definisce PathCompactPathEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 4.71 o successiva)