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

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj_core.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 5.0 ou posterior)
Conjunto de APIs	ext-ms-win-shell-shell32-l1-2-1 (introduzido no Windows 10, versão 10.0.10240)

Confira também

PathMakeUniqueName