Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

tmpnam_s, _wtmpnam_s

Genere los nombres que puede utilizar para crear los archivos temporales. Éstas son versiones de tmpnam y _wtmpnam con mejoras de seguridad como se describe en Características de seguridad en 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

[out] str

Puntero que contendrá el nombre generado.

[in] sizeInChars

El tamaño del búfer en caracteres.

ambas funciones devuelven 0 si correctamente o un número de error en el error.

condiciones de error

str

sizeInChars

Valor devuelto

Contenido de str

NULL

cualquier

EINVAL

no modificado

no NULL (señala memoria válido)

demasiado corto

ERANGE

no modificado

Si str es NULL, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros. Si la ejecución puede continuar, este errno establecido funciones a EINVAL y a EINVALreturn.

Cada una de estas funciones devuelve el nombre de un archivo que no existe actualmente. tmpnam_s devuelve un nombre único en el directorio de trabajo actual. La nota a un nombre de archivo con por una barra diagonal inversa y ninguna información de la ruta de acceso, por ejemplo \ fname21, esto indica que el nombre es válido para el directorio de trabajo actual.

Para tmpnam_s, puede almacenar este nombre de archivo generado en str. la longitud máxima de una cadena devuelta por tmpnam_s es L_tmpnam_s, definido en STDIO.H. si str es NULL, después tmpnam_s deja el resultado en un buffer estático interno. Para cualquier llamada subsiguiente destruye este valor. El nombre generado por tmpnam_s consta de un nombre de archivo programa-generado y, después de la primera llamada a tmpnam_s, una extensión de archivo números secuenciales en base 32 (.1-.1vvvvvu, cuando TMP_MAX_S en STDIO.H es INT_MAX).

tmpnam_s controla automáticamente argumentos de cadena de caracteres multibyte según corresponda, reconociendo secuencias de caracteres multibyte según la página de códigos OEM obtenida del sistema operativo. _wtmpnam_s es una versión con caracteres anchos de tmpnam_s; el argumento y el valor devuelto de _wtmpnam_s son cadenas de caracteres. _wtmpnam_s y tmpnam_s se comportan exactamente igual excepto que _wtmpnam_s no controla las cadenas de caracteres multibyte.

En C++, mediante estas funciones es simplificado con sobrecargas de plantilla; las sobrecargas pueden deducir longitud de búfer automáticamente, lo que elimina la necesidad de especificar un argumento size. Para obtener más información, vea Sobrecargas de plantilla de seguridad.

Asignaciones de la rutina de texto genérico

rutina de TCHAR.H

_UNICODE y _MBCS no definido

_MBCS definido

_UNICODE definido

_ttmpnam_s

tmpnam_s

tmpnam_s

_wtmpnam_s

rutina

Encabezado necesario

tmpnam_s

<stdio.h>

_wtmpnam_s

<stdio.h> o <wchar.h>

Para obtener información adicional de compatibilidad, vea compatibilidad en la Introducción.

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

No es aplicable Para llamar a la función estándar de C, utilice PInvoke. Para obtener más información, vea La invocación de plataforma ejemplos.

Adiciones de comunidad

AGREGAR
Mostrar: