Função PathYetAnotherMakeUniqueName (shlobj_core.h)

Cria um nome de arquivo exclusivo com base em um nome de arquivo existente.

Sintaxe

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

Parâmetros

[out] pszUniqueName

Tipo: PWSTR

Um buffer de cadeia de caracteres que recebe uma cadeia de caracteres Unicode terminada em nulo que contém o caminho totalmente qualificado do nome de arquivo exclusivo. Esse buffer deve ter pelo menos MAX_PATH caracteres para evitar causar um estouro de buffer.

[in] pszPath

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que contém o caminho totalmente qualificado da pasta que conterá o novo arquivo. Se pszShort for definido como NULL, essa cadeia de caracteres deverá conter um caminho de destino completo, terminando com o nome de arquivo longo no qual o novo nome de arquivo será baseado.

[in, optional] pszShort

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que contém o nome de arquivo curto no qual o nome exclusivo será baseado. Defina esse valor como NULL para criar um nome com base no nome de arquivo longo.

[in, optional] pszFileSpec

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que contém o nome de arquivo longo no qual o nome exclusivo será baseado.

Retornar valor

Tipo: BOOL

Retornará TRUE se um nome exclusivo tiver sido criado com êxito; caso contrário , FALSE.

Comentários

Se o caminho gerado exceder MAX_PATH caracteres, essa função poderá retornar uma cadeia de caracteres truncada em PathYetAnotherMakeUniqueName. Nesse caso, a função retorna FALSE.

Requisitos

Confira também

PathMakeUniqueName