_tempnam_dbg, _wtempnam_dbg
Versions des fonctions _tempnam, _wtempnam, tmpnam, _wtmpnam qui utilisent la version de débogage 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 );
Paramètres
dir
Chemin d'accès utilisé dans le nom de fichier en l'absence de 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_BLOCKou _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 de retour
Chaque fonction retourne un pointeur vers le nom généré ou NULL en cas de défaillance. Une défaillance peut se produire si un nom de répertoire non valide a été spécifié dans la variable d'environnement TMP et dans le paramètre dir.
Notes
free (ou free_dbg) doit être appelé pour les pointeurs alloués par _tempnam_dbg et _wtempnam_dbg.
Notes
Les fonctions _tempnam_dbget _wtempnam_dbgsont identiques à _tempnamet _wtempnamsauf que, quand _DEBUGest défini, ces fonctions utilisent la version de débogage de malloc et _malloc_dbg pour allouer la mémoire si la valeur NULL est passée comme premier paramètre. Pour plus d'informations, voir _malloc_dbg.
Dans la plupart des cas, vous n'avez pas besoin d'appeler ces fonctions de manière explicite. À 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 le blockType défini sur _NORMAL_BLOCK. Ainsi, vous n'avez pas besoin d'appeler ces fonctions de manière explicite sauf si vous souhaitez marquer les blocs du tas comme _CLIENT_BLOCK. Pour plus d'informations, voir Types de bloc sur le tas de débogage.
Mappages de routines de texte générique
Routine TCHAR.H |
_UNICODE et _MBCS non définis |
_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 plus d'informations sur la compatibilité, voir Compatibilité dans l'introduction.
Équivalent .NET Framework
Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, voir Exemples d'appel de code non managé.
Voir aussi
Référence
_tempnam, _wtempnam, tmpnam, _wtmpnam