Voltar à lista
Windows Win32Arquivos & E/Skernel32.dll

GetTempFileNameW

Gera um nome de arquivo único em um diretório especificado e cria o arquivo vazio.

Descrição

Análogo funcional de `mkstemp(3)` da libc, embora a criação e a geração do nome não sejam garantidamente atômicas contra todas as condições de corrida.

Header: fileapi.hDLL: kernel32.dll

Assinatura

UINT GetTempFileNameW(
    LPCWSTR lpPathName,
    LPCWSTR lpPrefixString,
    UINT uUnique,
    LPWSTR lpTempFileName
);

Parâmetros

ParâmetroTipoDescrição
lpPathNameLPCWSTRDiretório onde criar o arquivo.
lpPrefixStringLPCWSTRPrefixo do nome gerado (até 3 caracteres usados).
uUniqueUINTSe diferente de 0, usado para gerar o nome sem checar existência; se 0, o sistema garante um nome não utilizado.
lpTempFileNameLPWSTRRecebe o caminho completo do arquivo criado.

Valor de retorno

Diferente de zero em sucesso; 0 em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_BUFFER_OVERFLOW(111)
O nome do arquivo é grande demais para o buffer de destino.

Relacionadas

Mesma categoria

CopyFileWCreateDirectoryWCreateFileWDeleteFileWFindCloseFindFirstFileWFindNextFileWFlushFileBuffers