_tempnam_dbg, _wtempnam_dbg

Versions de fonction de _tempnam, , _wtempnam, _wtmpnamtmpnamqui utilisent la version de débogage de malloc, _malloc_dbg.

Syntaxe

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

Paramètres

dir
Chemin d’accès utilisé dans le nom de fichier s’il n’existe aucune variable d’environnement TMP ou si TMP n’est pas un répertoire valide.

prefix
Chaîne qui sera ajoutée aux noms retournés par _tempnam.

blockType
Type de bloc de mémoire demandé : _CLIENT_BLOCK ou _NORMAL_BLOCK.

filename
Pointeur vers le nom du fichier source qui a demandé l'opération d'allocation ou NULL.

linenumber
Numéro de ligne dans le fichier source où l'opération d'allocation a été demandée ou NULL.

Valeur retournée

Chaque fonction retourne un pointeur vers le nom généré ou NULL en cas d’échec. L’échec peut se produire s’il existe un nom de répertoire non valide spécifié dans la variable d’environnement TMP et dans le dir paramètre.

Remarque

free (ou free_dbg) doit être appelé pour les pointeurs alloués par _tempnam_dbg et _wtempnam_dbg.

Notes

Les _tempnam_dbg fonctions et _wtempnam_dbg les fonctions sont identiques et _tempnam_wtempnam sauf que, lorsqu’elles _DEBUG sont définies, ces fonctions utilisent la version de débogage et , pour allouer de malloc_malloc_dbgla mémoire si NULL elle est passée en tant que premier paramètre. Pour plus d’informations, consultez _malloc_dbg.

Vous n’avez pas besoin d’appeler ces fonctions explicitement dans la plupart des cas. À la place, vous pouvez définir l'indicateur _CRTDBG_MAP_ALLOC. Quand _CRTDBG_MAP_ALLOC est défini, les appels à _tempnam et _wtempnam sont remappés à _tempnam_dbg et _wtempnam_dbg, respectivement, avec blockType défini sur _NORMAL_BLOCK. Par conséquent, vous n’avez pas besoin d’appeler ces fonctions explicitement, sauf si vous souhaitez marquer les blocs de tas comme _CLIENT_BLOCK. Pour plus d’informations, consultez Types de bloc sur le tas de débogage.

Mappages de routine de texte générique

Routine TCHAR.H	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_ttempnam_dbg	_tempnam_dbg	_tempnam_dbg	_wtempnam_dbg

Spécifications

Routine	En-tête requis
_tempnam_dbg, _wtempnam_dbg	<crtdbg.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Voir aussi

_tempnam, _wtempnam, tmpnam, _wtmpnam
E/S de flux
Versions de débogage des fonctions d’allocation du tas