_fullpath_dbg, _wfullpath_dbg
Versions de _fullpath, _wfullpath qui utilisent la version de débogage de malloc pour allouer de la mémoire.
char *_fullpath_dbg( char *absPath, const char *relPath, size_t maxLength, int blockType, const char *filename, int linenumber ); wchar_t *_wfullpath_dbg( wchar_t *absPath, const wchar_t *relPath, size_t maxLength, int blockType, const char *filename, int linenumber );
Paramètres
absPath
Pointeur vers une mémoire tampon contenant le nom de chemin d'accès absolu ou complet, ou NULL.relPath
Nom de chemin d'accès relatif.maxLength
Longueur maximale de la mémoire tampon du nom de chemin d'accès absolu (absPath). Cette longueur est représentée en octets pour _fullpath mais en caractères larges (wchar_t) pour _wfullpath.blockType
Type de bloc de mémoire demandé : _CLIENT_BLOCK ou _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 une mémoire tampon contenant le nom de chemin d'accès absolu (absPath). En cas d'erreur (par exemple, si la valeur passée dans relPath comprend une lettre de lecteur qui n'est pas valide ou qui est introuvable, ou si la longueur du nom de chemin d'accès absolu créé (absPath) est supérieure à maxLength) la fonction retourne NULL.
Notes
Les fonctions _fullpath_dbg et _wfullpath_dbg sont identiques à _fullpath et _wfullpath sauf que, quand **_**DEBUG est défini, ces fonctions utilisent la version de débogage de malloc, _malloc_dbg pour allouer la mémoire si la valeur Null est passée comme premier paramètre. Pour plus d'informations sur les fonctionnalités de débogage de _malloc_dbg, 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 à _fullpath et _wfullpathsont remappés à _fullpath_dbg et _wfullpath_dbg, respectivement, avec leblockType 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 |
|---|---|---|---|
_tfullpath_dbg |
_fullpath_dbg |
_fullpath_dbg |
_wfullpath_dbg |
Configuration requise
Fonction |
En-tête requis |
|---|---|
_fullpath_dbg |
<crtdbg.h> |
_wfullpath_dbg |
<crtdbg.h> |
Pour plus d'informations sur la compatibilité, voir Compatibilité dans l'introduction.