_tempnam_dbg, _wtempnam_dbg
Versiones de función de _tempnam, _wtempnam, tmpnam, _wtmpnam que usan 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
Ruta de acceso que se usa en el nombre de archivo si no hay variable de entorno TMP, o si TMP no es un directorio válido.prefix
Cadena que se va a anteponer a los nombres devueltos por _tempnam.blockType
Tipo de bloque de memoria solicitado: _CLIENT_BLOCK o _NORMAL_BLOCK.filename
Puntero al nombre del archivo de código fuente que solicitó la operación de asignación o NULL.linenumber
Número de línea del archivo de código fuente en la que se solicitó la operación de asignación o valor NULL.
Valor devuelto
Cada función devuelve un puntero al nombre generado o NULL si se produce un error. Pueden surgir errores si existe un nombre de directorio no válido en la variable de entorno TMP y en el parámetro dir.
Nota
No es necesario llamar a free (o free_dbg) en el caso de los punteros asignados por _tempnam_dbg y _wtempnam_dbg.
Comentarios
Las funciones _tempnam_dbgy _wtempnam_dbgson idénticas a _tempnamy _wtempnamsalvo que, si _DEBUGse define, estas funciones usan la versión de depuración de malloc y _malloc_dbg para asignar memoria si se pasa NULL como primer parámetro. Para obtener más información, vea _malloc_dbg.
En la mayoría de los casos, no es necesario llamar a estas funciones explícitamente en la mayoría. En lugar de ello, se puede definir la marca _CRTDBG_MAP_ALLOC. Si se define _CRTDBG_MAP_ALLOC, las llamadas a _tempnam y _wtempnam se reasignan a _tempnam_dbg y _wtempnam_dbg, respectivamente, con el parámetro blockType establecido en _NORMAL_BLOCK. Por consiguiente, no necesario llamar a estas funciones explícitamente a menos que se desee marcar los bloques del montón como _CLIENT_BLOCK. Para obtener más información, vea Tipos de bloques en el montón de depuración.
Asignaciones de rutina de texto genérico
Rutina TCHAR.H |
_UNICODE y _MBCS no definidos |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_ttempnam_dbg |
_tempnam_dbg |
_tempnam_dbg |
_wtempnam_dbg |
Requisitos
Rutina |
Encabezado necesario |
---|---|
_tempnam_dbg, _wtempnam_dbg |
<crtdbg.h> |
Para más información sobre compatibilidad, vea Compatibilidad en la introducción.
Equivalente en .NET Framework
No es aplicable. Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.
Vea también
Referencia
_tempnam, _wtempnam, tmpnam, _wtmpnam
Conceptos
Versiones de depuración de las funciones de asignación del montón