_fullpath_dbg, _wfullpath_dbg

Article
03/04/2013

Versions de _fullpath, _wfullpath qui utilisent la version debug d' 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 comprenant absolu ou le chemin d'accès complet, ou NULL.
relPath
Nom du chemin d'accès relatif.
maxLength
longueur maximale de la mémoire tampon de chemin d'accès absolu (absPath).Cette longueur est en octets pour _fullpath mais caractères larges (wchar_t) pour _wfullpath.
blockType
type demandé de bloc de mémoire : _CLIENT_BLOCK ou _NORMAL_BLOCK.
filename
Pointeur vers le nom du fichier source qui a demandé l'opération ou l' NULLd'allocation.
linenumber
Numéro de ligne dans le fichier source où l'opération d'allocation a été demandée ni NULL.

Valeur de retour

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

Notes

Les fonctions d' _fullpath_dbg et d' _wfullpath_dbg sont identiques à _fullpath et à _wfullpath mais, lorsque **_**DEBUGest défini, ces fonctions utilisent la version debug d' malloc, _malloc_dbg, pour allouer de la mémoire si NULL est passé comme premier paramètre.Pour plus d'informations sur les fonctionnalités de débogage d' _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 la balise d' _CRTDBG_MAP_ALLOC .Lorsque _CRTDBG_MAP_ALLOCest défini, les appels à _fullpath et l' _wfullpathsont remappés à _fullpath_dbg et à _wfullpath_dbg, respectivement, avec blockType défini à _NORMAL_BLOCK.Ainsi, 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

routine de 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 de compatibilité, consultez Compatibilité dans l'introduction.

Équivalent .NET Framework

Create

Voir aussi

Référence

Gestion de fichiers

_fullpath, _wfullpath

Concepts

Versions Debug des fonctions d'allocation du tas

Partager via