_tempnam_dbg, _wtempnam_dbg

Article
03/04/2013

Fonction les versions de _tempnam, _wtempnam, tmpnam, _wtmpnam qui utilisent la version debug d' 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 
);

Paramètres

dir
Le 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 non valide.
prefix
La chaîne qui sera ajoutée au début aux noms retournée par _tempnam.
blockType
type demandé de bloc de mémoire : _CLIENT_BLOCKou _NORMAL_BLOCK.
filename
Pointeur vers le nom du fichier source qui a demandé l'opération ou l' NULLd'allocation.
linenumber
Numéro de ligne dans le fichier source où l'opération d'allocation a été demandée ni NULL.

Valeur de retour

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

[!REMARQUE]

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

Notes

Les fonctionsd' _tempnam_dbgetd' _wtempnam_dbgsont identiques à _tempnamet à _wtempnammais, lorsque _DEBUGest défini, ces fonctions utilisent la version debug d' malloc et d' _malloc_dbg, pour allouer de la mémoire si NULL est passé comme 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 la balise _CRTDBG_MAP_ALLOC.Lorsque _CRTDBG_MAP_ALLOC est défini, les appels à _tempnam et l' _wtempnam sont remappés à_tempnam_dbg et à _wtempnam_dbg, respectivement, avec blockType défini à _NORMAL_BLOCK.Ainsi, 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 routines de texte générique

routine de TCHAR.H	_MBCS & de _UNICODE non défini	_MBCS défini	_UNICODE défini
_ttempnam_dbg	_tempnam_dbg	_tempnam_dbg	_wtempnam_dbg

Configuration requise

routine	en-tête requis
_tempnam_dbg, _wtempnam_dbg	<crtdbg.h>

Pour des informations de compatibilité supplémentaires, consultez Compatibilité dans l'introduction.

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de code non managé.

Voir aussi

Référence

_tempnam, _wtempnam, tmpnam, _wtmpnam

E/S de flux

Concepts

Versions Debug des fonctions d'allocation du tas

Partager via