_getdcwd_dbg
, _wgetdcwd_dbg
Déboguer les versions des _getdcwd
fonctions , _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 ENOMEM
sur , 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 routine de texte générique
Routine Tchar.h | _UNICODE et _MBCS non défini |
_MBCS Défini |
_UNICODE Défini |
---|---|---|---|
_tgetdcwd_dbg |
_getdcwd_dbg |
_getdcwd_dbg |
_wgetdcwd_dbg |
Spécifications
Routine | En-tête requis |
---|---|
_getdcwd_dbg |
<crtdbg.h> |
_wgetdcwd_dbg |
<crtdbg.h> |
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour