Função PathMakeUniqueName (shlobj_core.h)

Cria um nome de caminho exclusivo de um modelo.

Sintaxe

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

Parâmetros

[out] pszUniqueName

Tipo: PWSTR

Um buffer que recebe uma cadeia de caracteres Unicode terminada em nulo que contém o nome do caminho exclusivo. Deve ter pelo menos MAX_PATH caracteres de comprimento.

cchMax

Tipo: UINT

O número de caracteres no buffer apontado por pszUniqueName.

[in] pszTemplate

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que contém um modelo usado para construir o nome exclusivo. Esse modelo é usado para unidades que exigem nomes de arquivo com o formato 8.3. Essa cadeia de caracteres não deve ter mais do que MAX_PATH caracteres de comprimento, incluindo o caractere nulo de terminação.

[in, optional] pszLongPlate

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que contém um modelo usado para construir o nome exclusivo. Esse modelo é usado para unidades que dão suporte a nomes de arquivo longos. Essa cadeia de caracteres não deve ter mais do que MAX_PATH caracteres de comprimento, incluindo o caractere nulo de terminação.

[in, optional] pszDir

Tipo: PCWSTR

Uma cadeia de caracteres terminada em nulo que contém o diretório no qual o novo arquivo reside. Essa cadeia de caracteres não deve ter mais do que MAX_PATH caracteres de comprimento, incluindo o caractere nulo de terminação.

Valor retornado

Tipo: BOOL

Retorna TRUE se tiver êxito; caso contrário, FALSE.

Comentários

Essa função gera um novo nome de arquivo exclusivo com base nos modelos especificados por pszTemplate, para unidades que exigem o formato 8.3 e pszLongPlate para unidades que dão suporte a nomes de arquivo longos. Por exemplo, se você especificar "My New Filename" para pszLongPlate, PathMakeUniqueName retornará nomes como "My New Filename (1)", "My New Filename (2)" e assim por diante.

Requisitos