Funzione PathCompactPathExW (shlwapi.h)

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

Sintassi

BOOL PathCompactPathExW(
  [out] LPWSTR  pszOut,
  [in]  LPCWSTR 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 usava. 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)