_getdcwd_dbg, _wgetdcwd_dbg
Versions de débogage des fonctions _getdcwd, _wgetdcwd (disponibles uniquement durant le débogage).
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 d'accès.maxlen
Longueur maximale du chemin d'accès en caractères : char pour _getdcwd_dbget wchar_tpour _wgetdcwd_dbg.blockType
Type demandé du bloc de mémoire : _CLIENT_BLOCKou _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 de retour
Retourne un pointeur vers buffer. Une valeur de retour NULL indique une erreur et errno prend la valeur ENOMEM, ce qui indique que la mémoire est insuffisante pour allouer maxlen octets (quand un argument NULL est donné comme buffer), ou la valeur ERANGE, ce qui indique que le chemin d'accès fait plus de 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, voir _malloc_dbg.
Dans la plupart des cas, vous n'avez pas besoin d'appeler ces fonctions de manière explicite. À 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. Ainsi, vous n'avez pas besoin d'appeler ces fonctions de manière explicite sauf si vous souhaitez marquer les blocs du tas comme _CLIENT_BLOCK. Pour plus d'informations, voir Types de bloc sur le tas de débogage.
Mappages de routines de texte générique
Routine Tchar.h |
_UNICODE et _MBCS non définis |
_MBCS défini |
_UNICODE défini |
|---|---|---|---|
_tgetdcwd_dbg |
_getdcwd_dbg |
_getdcwd_dbg |
_wgetdcwd_dbg |
Configuration requise
Routine |
En-tête requis |
|---|---|
_getdcwd_dbg |
<crtdbg.h> |
_wgetdcwd_dbg |
<crtdbg.h> |
Pour plus d'informations sur la compatibilité, voir Compatibilité dans l'introduction.