_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

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

Configuration requise

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