_tempnam_dbg, _wtempnam_dbg

Versiones de la función de _tempnam, _wtempnam, tmpnam, _wtmpnam que utilizan la versión de depuración de malloc, _malloc_dbg.

char *_tempnam_dbg(
   const char *dir,
   const char *prefix,
   int blockType,
   const char *filename,
   int linenumber 
);
wchar_t *_wtempnam_dbg(
   const wchar_t *dir,
   const wchar_t *prefix,
   int blockType,
   const char *filename,
   int linenumber 
);

Parámetros

• dir
  La ruta de acceso utilizada en el nombre de archivo si no hay ninguna variable de entorno TMP, o si TMP no es un directorio válido.

• prefix
  La cadena que por los nombres devuelto por _tempnam.

• blockType
  tipo solicitado de bloque de memoria: _CLIENT_BLOCKo _NORMAL_BLOCK.

• filename
  Puntero al nombre del archivo de código fuente que solicitó la operación o NULLde asignación.

• linenumber
  Número de línea en el archivo de código fuente donde la operación de asignación se solicitó o NULL.

Valor devuelto

Cada función devuelve un puntero al nombre generado o a NULL si hay un error.El error puede producirse si hay un nombre de directorio no válido especificado en la variable de entorno TMP y en el parámetro de dir .

[!NOTA]

free (o free_dbg) necesita llamar para punteros asignados por _tempnam_dbg y _wtempnam_dbg.

Comentarios

Las funcionesde _tempnam_dbgyde _wtempnam_dbgson idénticas a _tempnamy a _wtempnamsalvo que, cuando _DEBUGestá definido, estas funciones utilizan la versión de depuración de malloc y de _malloc_dbg, para asignar memoria si NULL se pasa como primer parámetro.Para obtener más información, vea _malloc_dbg.

No necesita llamar a estas funciones explícitamente en la mayoría de los casos.En su lugar, puede definir el marcador _CRTDBG_MAP_ALLOC.Cuando _CRTDBG_MAP_ALLOC está definido, las llamadas a _tempnam y _wtempnam se reasignan a_tempnam_dbg y a _wtempnam_dbg, respectivamente, con blockType establecido en _NORMAL_BLOCK.Por consiguiente, no necesita llamar a estas funciones explícitamente a menos que desee marcar los bloques de pila como _CLIENT_BLOCK.Para obtener más información, vea Tipos de bloques en el montón de depuración.

Asignaciones de la rutina de texto genérico

rutina de TCHAR.H	_UNICODE y _MBCS no definido	_MBCS definido	_UNICODE definido
_ttempnam_dbg	_tempnam_dbg	_tempnam_dbg	_wtempnam_dbg

Requisitos

rutina	Encabezado necesario
_tempnam_dbg, _wtempnam_dbg	<crtdbg.h>

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

Equivalente en .NET Framework

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

Vea también

Referencia

_tempnam, _wtempnam, tmpnam, _wtmpnam

E/S de la secuencia

Conceptos

Versiones de depuración de las funciones de asignación del montón