Funzione PathUndecorateW (shlwapi.h)

Rimuove la decorazione da una stringa di percorso.

Sintassi

void PathUndecorateW(
  [in, out] LPWSTR pszPath
);

Parametri

[in, out] pszPath

Tipo: LPTSTR

Stringa con terminazione Null di lunghezza MAX_PATH che contiene il percorso. Quando la funzione viene restituita, pszPath punta alla stringa non dichiarata.

Valore restituito

Nessuno

Osservazioni

Una decorazione è costituita da una coppia di parentesi quadre con una o più cifre tra di esse, inserite immediatamente dopo il nome di base e prima dell'estensione del nome file.

Esempi

Nella tabella seguente viene illustrato come le stringhe vengono modificate da PathUndecorate.

Stringa iniziale	Stringa nondecorata
C:\Path\File[5].txt	C:\Path\File.txt
C:\Path\File[12]	C:\Path\File
C:\Path\File.txt	C:\Path\File.txt
C:\Path\[3].txt	C:\Path\[3].txt

 

Nota

L'intestazione shlwapi.h definisce PathUndecorate 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 5.0 o successiva)