Partager via


_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

E/S de flux

Concepts

Versions Debug des fonctions d'allocation du tas