GetTempFileName

9/8/2008

Essa função cria um nome para um arquivo temporário. Nome de arquivo é a concatenação do caminho especificado e seqüências de caracteres de prefixo, um hexadecimal seqüência de caracteres formadas de um inteiro especificado e a extensão .TMP.

Se você especificar um inteiro Other Than zero, a função cria o nome arquivo, mas não criará o arquivo. Se você especificar zero para o inteiro, a função cria um exclusivo nome arquivo e cria o arquivo no Diretório especificado.

Syntax

UINT GetTempFileName(
  LPCTSTR lpPathName, 
  LPCTSTR lpPrefixString, 
  UINT uUnique, 
  LPTSTR lpTempFileName
);

Parameters

• lpPathName
  [no] Aponta para um seqüência de caracteres NULL-Terminated que especifica o caminho para o nome arquivo Diretório. Esta seqüência de caracteres devem consistir em caracteres na conjunto de caracteres ANSI. Porque a concepção de um atual Diretório não existe em Windows Embedded CE, você deve especificar o caminho completo Diretório. Se este parâmetro for definido como NULL, o função falhar.

• lpPrefixString
  [no] Aponta para um seqüência de caracteres NULL-Terminated prefixo. A função utiliza os três primeiros caracteres deste seqüência de caracteres como o prefixo do nome do arquivo. Esta seqüência de caracteres devem consistir em caracteres na conjunto de caracteres ANSI.

• uUnique
  [no] Especifica um inteiro sem assinatura que a função converte para um hexadecimal seqüência de caracteres para uso em criação de nome arquivo temporário.

  Se este parâmetro for definido como diferente de zero, a função acrescenta o hexadecimal seqüência de caracteres para lpPrefixString a forma de nome arquivo temporário. Neste maiúsculas e minúsculas, a função não cria o arquivo especificado e não testar se o nome arquivo é exclusivo.

  Se este parâmetro for definido para zero, a função usa um hexadecimal seqüência de caracteres derivado do atual hora do sistema. Neste maiúsculas e minúsculas, a função usa valores diferentes até encontrar um exclusivo nome arquivo e em seguida, ele cria o arquivo na lpPathName virtual.

• lpTempFileName
  [out] Ponteiro para a reserva que recebe o nome arquivo temporário. Esta seqüência de caracteres NULL-Terminated consiste em caracteres na conjunto de caracteres ANSI. Para acomodar o caminho, esta reserva deve ter pelo menos o comprimento, em bytes, especificado por MAX_PATH.

Return Value

O valor numérico usado no nome do arquivo temporário exclusivo indica sucesso. Se uUnique está definido para diferente de zero, o valor de retorno especifica esse número. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Essa função cria um nome arquivo temporário. O seguinte mostra a forma do nome de arquivo temporário exemplo de código.

path\preuuuu.TMP 

A seguinte tabela descreve a sintaxe nome arquivo.

Componente	Descrição
caminho	Caminho especificado por lpPathName.
a versão anterior	Três primeiras letras da lpPrefixString seqüência de caracteres.
uuuu	Valor hexadecimal de uUnique.

Quando um Windows Embedded CE com dispositivo estiver desativado, arquivos temporários cujos nomes foram criados por essa função não são automaticamente excluídos.

Para evitar problemas resultantes de converter um seqüência de caracteres conjunto de caracteres ANSI um seqüência do Windows, a função CreateFile para criar um arquivo temporário.

Se uUnique está definido para zero, essa função tenta forma uma exclusivo número baseia a atual hora do sistema. Se existe um arquivo com nome de arquivo resultante, outro número é gerado e a testar a existência é repetido. Testando continua até que um exclusivo nome arquivo for encontrado. Essa função, em seguida, cria um arquivo por esse nome e o fecha. Quando uUnique está definido para diferente de zero, nenhuma tentativa é feita para criar e aberto o arquivo.

Windows Embedded CE PADs um nome arquivo com zeros quando ele tiver hexadecimal Fewer than quatro dígitos em seu nome. De exemplo, um área de trabalho Windows OS cria <Nome do arquivo> 34.tmp, enquanto cria Windows Embedded CE <Nome do arquivo> 0034.tmp.

Requirements

Header	winbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

File I/O Functions
CreateFile