_fullpath_dbg, _wfullpath_dbg

Versions de _fullpath, _wfullpath qui utilisent la version de débogage de pour allouer de malloc la mémoire.

Syntaxe

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_dbg mais en caractères larges (wchar_t) pour _wfullpath_dbg.

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 retournée

Chaque fonction retourne un pointeur vers une mémoire tampon contenant le nom de chemin d'accès absolu (absPath). S’il existe une erreur (par exemple, si la valeur passée relPath inclut une lettre de lecteur qui n’est pas valide ou introuvable, ou si la longueur du nom de chemin absolu créé (absPath) est supérieure maxLengthà ) la fonction retourne NULL.

Notes

Les _fullpath_dbg fonctions et _wfullpath_dbg les fonctions sont identiques et _wfullpath _fullpath sauf que, lorsqu’elles _DEBUG sont définies, ces fonctions utilisent la version de débogage de , _malloc_dbgpour allouer de mallocla mémoire si NULL elle est passée en tant que premier paramètre. Pour plus d’informations sur les fonctionnalités de débogage de _malloc_dbg, consultez _malloc_dbg.

Vous n’avez pas besoin d’appeler ces fonctions explicitement dans la plupart des cas. À la place, vous pouvez définir l'indicateur _CRTDBG_MAP_ALLOC. Quand _CRTDBG_MAP_ALLOC est défini, les appels à _fullpath et _wfullpath sont remappés à _fullpath_dbg et _wfullpath_dbg, respectivement, avec blockType défini sur _NORMAL_BLOCK. Par conséquent, vous n’avez pas besoin d’appeler ces fonctions explicitement, sauf si vous souhaitez marquer les blocs de 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

Spécifications

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Voir aussi

Gestion des fichiers
_fullpath, _wfullpath
Versions de débogage des fonctions d’allocation du tas