tmpnam_s, _wtmpnam_s

Artigo
06/09/2015

Gerencia nomes que você pode usar para criar arquivos temporários. Essas são versões de tmpnam e _wtmpnam com aprimoramentos de segurança conforme descrito em Recursos de segurança no CRT.

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

[saída] str
Ponteiro que conterá o nome gerado.
[entrada] sizeInChars
O tamanho do buffer em caracteres.

Valor de retorno

Essas duas funções retornam 0 se bem-sucedido ou um número de erro de falha.

Condições de erro

str	sizeInChars	Valor de Retorno	Contents of str
NULL	any	EINVAL	não modificado
não NULL (pontos para a memória válido)	muito curto	ERANGE	não modificado

Se str é NULL, o parâmetro de manipulador inválido é invocado, como descrito em Validação do parâmetro. Se a execução puder 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 de trabalho atual. A observe que quando um nome de arquivo pre-pended com uma barra invertida e nenhuma informação de caminho, como \ fname21, isso indicará que o nome é válido para o diretório de trabalho atual.

Para tmpnam_s, você pode armazenar este nome de arquivo gerado em str. O comprimento máximo de uma cadeia de caracteres retornada por tmpnam_s é L_tmpnam_s, definido em. STDIO.H. Se str é NULL, então tmpnam_s permite que o resultado em um buffer interno estático. Para todas as chamadas subsequentes destroem esse valor. O nome gerado por tmpnam_s consiste em um nome de arquivo gerado por programa e, depois da primeira chamada a 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 controla automaticamente argumentos de cadeia de caracteres de multibyte- caracteres conforme apropriado, confirmando sequências de multibyte- caractere de acordo com a página de código OEM obtida do sistema operacional. _wtmpnam_s é uma versão de ampla caractere de tmpnam_s; o argumento e o valor de retorno de _wtmpnam_s são cadeias de caracteres de ampla caractere. _wtmpnam_s e tmpnam_s se comportam idêntica exceto que _wtmpnam_s não trata as cadeias de caracteres de multibyte- caractere.

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

Mapeamentos da rotina de texto genérico

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_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 informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.

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 );
      }
   }  
}