Condividi tramite

Funzione PathYetAnotherMakeUniqueName (shlobj_core.h)

  • Articolo

Crea un nome file univoco basato su un nome file esistente.

Sintassi

BOOL PathYetAnotherMakeUniqueName(
  [out]          PWSTR  pszUniqueName,
  [in]           PCWSTR pszPath,
  [in, optional] PCWSTR pszShort,
  [in, optional] PCWSTR pszFileSpec
);

Parametri

[out] pszUniqueName

Tipo: PWSTR

Buffer stringa che riceve una stringa Unicode con terminazione null contenente il percorso completo del nome file univoco. Questo buffer deve essere almeno MAX_PATH caratteri a lungo per evitare di causare un overrun del buffer.

[in] pszPath

Tipo: PCWSTR

Stringa Unicode con terminazione null contenente il percorso completo della cartella che conterrà il nuovo file. Se pszShort è impostato su NULL, questa stringa deve contenere un percorso di destinazione completo, terminando con il nome di file lungo su cui si basa il nuovo nome di file.

[in, optional] pszShort

Tipo: PCWSTR

Stringa Unicode con terminazione null contenente il nome breve del file su cui si basa il nome univoco. Impostare questo valore su NULL per creare un nome in base al nome di file lungo.

[in, optional] pszFileSpec

Tipo: PCWSTR

Stringa Unicode con terminazione null contenente il nome di file lungo su cui si basa il nome univoco.

Valore restituito

Tipo: BOOL

Restituisce TRUE se è stato creato correttamente un nome univoco; in caso contrario FALSE.

Commenti

Se il percorso generato supera MAX_PATH caratteri, questa funzione può restituire una stringa troncata in PathYetAnotherMakeUniqueName. In tal caso, la funzione restituisce FALSE.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h (include Shlobj.h)
Libreria Shell32.lib
DLL Shell32.dll (versione 5.0 o successiva)
Set di API ext-ms-win-shell-shell32-l1-2-1 (introdotta in Windows 10, versione 10.0.10240)

Vedi anche

PathMakeUniqueName