Funzione PathMakeUniqueName (shlobj_core.h)

Crea un nome di percorso univoco da un modello.

Sintassi

BOOL PathMakeUniqueName(
  [out]          PWSTR  pszUniqueName,
                 UINT   cchMax,
  [in]           PCWSTR pszTemplate,
  [in, optional] PCWSTR pszLongPlate,
  [in, optional] PCWSTR pszDir
);

Parametri

[out] pszUniqueName

Tipo: PWSTR

Buffer che riceve una stringa Unicode con terminazione null contenente il nome del percorso univoco. Deve essere almeno MAX_PATH caratteri in lunghezza.

cchMax

Tipo: UINT

Numero di caratteri nel buffer a cui punta pszUniqueName.

[in] pszTemplate

Tipo: PCWSTR

Stringa Unicode con terminazione null contenente un modello usato per costruire il nome univoco. Questo modello viene usato per le unità che richiedono nomi di file con il formato 8.3. Questa stringa non deve essere più di MAX_PATH caratteri in lunghezza, incluso il carattere null terminante.

[in, optional] pszLongPlate

Tipo: PCWSTR

Stringa Unicode con terminazione null contenente un modello usato per costruire il nome univoco. Questo modello viene usato per le unità che supportano nomi di file lunghi. Questa stringa non deve essere più di MAX_PATH caratteri in lunghezza, incluso il carattere null terminante.

[in, optional] pszDir

Tipo: PCWSTR

Stringa con terminazione null contenente la directory in cui risiede il nuovo file. Questa stringa non deve essere più di MAX_PATH caratteri in lunghezza, incluso il carattere null terminante.

Valore restituito

Tipo: BOOL

Restituisce TRUE se ha esito positivo; in caso contrario, FALSE.

Commenti

Questa funzione genera un nuovo nome di file univoco basato sui modelli specificati da pszTemplate, per le unità che richiedono il formato 8.3 e pszLongPlate per le unità che supportano nomi di file lunghi. Ad esempio, se si specifica "My New Filename" per pszLongPlate, PathMakeUniqueName restituisce nomi come "My New Filename (1)", "My New Filename (2)" e così via.

Requisiti