tmpnam_s, _wtmpnam_s

Gere nomes que podem ser usados para criar arquivos temporários. Essas funções são versões e com aprimoramentos de segurança, conforme descrito em Recursos de tmpnam_wtmpnamsegurança na CRT.

Sintaxe

errno_t tmpnam_s(
   char * str,
   size_t sizeInChars
);
errno_t _wtmpnam_s(
   wchar_t *str,
   size_t sizeInChars
);
template <size_t size>
errno_t tmpnam_s(
   char (&str)[size]
); // C++ only
template <size_t size>
errno_t _wtmpnam_s(
   wchar_t (&str)[size]
); // C++ only

Parâmetros

str
[saiu] Ponteiro que contém o nome gerado.

sizeInChars
[em] O tamanho do buffer em caracteres.

Retornar valor

Ambas as funções retornarão 0 se tiverem êxito ou um número de erro em caso de falha.

Condições de erro

str	sizeInChars	Retornar valor	Conteúdo de str
NULL	qualquer	EINVAL	não modificado
não é NULL (aponta para a memória válida)	muito curto	ERANGE	não modificado

Se str for NULL, o manipulador de parâmetros inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, essas funções definirão errno como EINVAL e retornarão EINVAL.

Comentários

Cada uma dessas funções retorna o nome de um arquivo que não existe no momento. tmpnam_s retorna um nome exclusivo no diretório temporário designado do Windows retornado por GetTempPathW. Quando um nome de arquivo é precedido por uma barra invertida e nenhuma informação de caminho, como \fname21, isso indica que o nome é válido para o diretório de trabalho atual.

Para tmpnam_s, é possível armazenar esse nome de arquivo gerado em str. O tamanho máximo de uma cadeia de caracteres retornada por tmpnam_s é L_tmpnam_s, definido em STDIO.H. Se str for NULL, tmpnam_s deixará o resultado em um buffer estático interno. Portanto, todas as chamadas posteriores destroem esse valor. O nome gerado por consiste em um nome de arquivo gerado por tmpnam_s programa e, após a primeira chamada para tmpnam_s, uma extensão de arquivo de números sequenciais na base 32 (.1-.1vvvvvu, quando TMP_MAX_S em STDIO. H é INT_MAX).

tmpnam_s manipula automaticamente argumentos da cadeia de caracteres multibyte conforme apropriado, reconhecendo as sequências de caracteres multibyte de acordo com a página de código do OEM obtida do sistema operacional. _wtmpnam_s é uma versão de caractere largo de tmpnam_s; o argumento e o valor retornado de _wtmpnam_s são cadeias de caracteres largos. _wtmpnam_s e tmpnam_s têm comportamento idêntico, exceto pelo fato de que _wtmpnam_s não manipula cadeias de caracteres multibyte.

No C++, o uso dessas funções é simplificado por sobrecargas de modelo. As sobrecargas podem inferir automaticamente o tamanho do buffer, eliminando a necessidade de especificar um argumento de tamanho. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_ttmpnam_s	tmpnam_s	tmpnam_s	_wtmpnam_s

Requisitos

Rotina	Cabeçalho necessário
tmpnam_s	<stdio.h>
_wtmpnam_s	<stdio.h> ou <wchar.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// crt_tmpnam_s.c
// This program uses tmpnam_s to create a unique filename in the
// current working directory.
//

#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   char name1[L_tmpnam_s];
   errno_t err;
   int i;

   for (i = 0; i < 15; i++)
   {
      err = tmpnam_s( name1, L_tmpnam_s );
      if (err)
      {
         printf("Error occurred creating unique filename.\n");
         exit(1);
      }
      else
      {
         printf( "%s is safe to use as a temporary file.\n", name1 );
      }
   }
}

C:\Users\LocalUser\AppData\Local\Temp\u19q8.0 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.1 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.2 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.3 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.4 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.5 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.6 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.7 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.8 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.9 is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.a is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.b is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.c is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.d is safe to use as a temporary file.
C:\Users\LocalUser\AppData\Local\Temp\u19q8.e is safe to use as a temporary file.

Confira também

E/S de fluxo
_getmbcp
malloc
_setmbcp
tmpfile_s