_getdcwd_dbg, _wgetdcwd_dbg

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

Syntaxe

char *_getdcwd_dbg(
   int drive,
   char *buffer,
   int maxlen,
   int blockType,
   const char *filename,
   int linenumber
);
wchar_t *_wgetdcwd_dbg(
   int drive,
   wchar_t *buffer,
   int maxlen,
   int blockType,
   const char *filename,
   int linenumber
);

Paramètres

drive
Nom du lecteur de disque.

buffer
Emplacement de stockage pour le chemin.

maxlen
Longueur maximale du chemin d'accès en caractères : char pour _getdcwd_dbg et wchar_t pour _wgetdcwd_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 fonctions _getdcwd_dbg et _wgetdcwd_dbg sont identiques à _getdcwd et _wgetdcwd, sauf quand _DEBUG est défini : ces fonctions utilisent alors la version de débogage de malloc et _malloc_dbg pour allouer de la mémoire si NULL est passé comme paramètre buffer. 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 à _getdcwd et _wgetdcwd sont remappés à _getdcwd_dbg et _wgetdcwd_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

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