_tempnam_dbg, _wtempnam_dbg

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Versions des fonctions _tempnam, _wtempnam, tmpnam, _wtmpnam qui utilisent la version debug 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.

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.

System_CAPS_ICON_note.jpg Remarque

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

Le _tempnam_dbget _wtempnam_dbgfonctions sont identiques aux _tempnamet _wtempnam, sauf que, lorsque _DEBUGest défini, ces fonctions utilisent la version debug de malloc et _malloc_dbgpour allouer la mémoire si NULL est passée comme premier paramètre. Pour plus d’informations, consultez _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 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, consultez 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
RoutineEn-tête requis
_tempnam_dbg, _wtempnam_dbg<crtdbg.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité dans l'introduction.

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

_tempnam, _wtempnam, tmpnam, _wtmpnam
Flux d’e/s
Versions Debug des fonctions d’Allocation du tas

Afficher: