_tempnam_dbg, _wtempnam_dbg

Versioni delle funzioni di _tempnam, _wtempnam, tmpnam, _wtmpnam che usano la versione di debug di malloc, _malloc_dbg.

Sintassi

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

Parametri

dir
Percorso usato nel nome del file se non è presente alcuna variabile di ambiente TMP o se TMP non è una directory valida.

prefix
La stringa da anteporre ai nomi restituiti da _tempnam.

blockType
Tipo richiesto di blocco di memoria: _CLIENT_BLOCK o _NORMAL_BLOCK.

filename
Puntatore al nome del file di origine che ha richiesto l'operazione di allocazione o NULL.

linenumber
Numero di riga nel file di origine in cui è stata richiesta l'operazione di allocazione o NULL.

Valore restituito

Ogni funzione restituisce un puntatore al nome generato o NULL in caso di errore. L'errore può verificarsi se è presente un nome di directory non valido specificato nella variabile di ambiente TMP e nel dir parametro .

Nota

Non è necessario chiamare free (o free_dbg) per puntatori allocati da _tempnam_dbg e _wtempnam_dbg.

Osservazioni:

Le _tempnam_dbg funzioni e _wtempnam_dbg sono identiche a _tempnam e _wtempnam ad eccezione del fatto che, quando _DEBUG viene definito, queste funzioni usano la versione di debug di malloc e _malloc_dbg, per allocare memoria se NULL viene passato come primo parametro. Per ulteriori informazioni, vedere _malloc_dbg.

Non è necessario chiamare queste funzioni in modo esplicito nella maggior parte dei casi. In alternativa, è possibile definire il flag _CRTDBG_MAP_ALLOC. Quando _CRTDBG_MAP_ALLOC è definito, le chiamate a _tempnam e _wtempnam vengono mappate nuovamente a _tempnam_dbg e _wtempnam_dbg rispettivamente, con blockType impostato su _NORMAL_BLOCK. Pertanto, non è necessario chiamare queste funzioni in modo esplicito, a meno che non si voglia contrassegnare i blocchi dell'heap come _CLIENT_BLOCK. Per altre informazioni, vedere Tipi di blocchi sull'heap di debug.

Mapping di routine di testo generico

Routine TCHAR.H	_UNICODE e _MBCS non definito	_MBCS definito	_UNICODE definito
_ttempnam_dbg	_tempnam_dbg	_tempnam_dbg	_wtempnam_dbg

Requisiti

Ciclo	Intestazione obbligatoria
_tempnam_dbg, _wtempnam_dbg	<crtdbg.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Vedi anche

_tempnam, _wtempnam, tmpnam_wtmpnam
I/O di flusso
Versioni di debug di funzioni di allocazione heap