Funzione PathYetAnotherMakeUniqueName (shlobj_core.h)

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

Vedi anche

PathMakeUniqueName