_getcwd_dbg, _wgetcwd_dbg

Déboguer les versions des _getcwdfonctions , _wgetcwd (disponible uniquement pendant le débogage).

Syntaxe

char *_getcwd_dbg(
   char *buffer,
   int maxlen,
   int blockType,
   const char *filename,
   int linenumber
);
wchar_t *_wgetcwd_dbg(
   wchar_t *buffer,
   int maxlen,
   int blockType,
   const char *filename,
   int linenumber
);

Paramètres

buffer
Emplacement de stockage pour le chemin.

maxlen
Longueur maximale du chemin d'accès en caractères : char pour _getcwd_dbg et wchar_t pour _wgetcwd_dbg.

blockType
Type demandé du bloc de mémoire : _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

Retourne un pointeur vers buffer. Une NULL valeur de retour indique une erreur et errno est définie ENOMEMsur , indiquant qu’il n’y a pas de mémoire suffisante pour allouer des maxlen octets (lorsqu’un NULL argument est donné en tant que buffer), ou à ERANGE, indiquant que le chemin d’accès est plus long que les maxlen caractères.

Pour plus d'informations, voir errno, _doserrno, _sys_errlist et _sys_nerr.

Notes

Les _getcwd_dbg fonctions et _wgetcwd_dbg les fonctions sont identiques et _wgetcwd _getcwd sauf que, lorsqu’elles _DEBUG sont définies, ces fonctions utilisent la version de débogage de et _malloc_dbg pour allouer de malloc la mémoire si NULL elle est passée en tant que premier paramètre. Pour plus d’informations, 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 à _getcwd et _wgetcwd sont remappés à _getcwd_dbg et _wgetcwd_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.

Mappage de routine de texte générique

Spécifications

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

Voir aussi

_getcwd, _wgetcwd
Contrôle d’annuaire
Versions de débogage des fonctions d’allocation du tas