Funzione PathCompactPathExA (shlwapi.h)

Articolo
11/20/2024

Tronca un percorso per adattarsi all'interno di 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 contenente 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 in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite