_getdcwd_dbg, _wgetdcwd_dbg

 

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

Les versions Debug de la _getdcwd, _wgetdcwd fonctions (disponibles uniquement pendant 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.

maxlen
Longueur maximale du chemin d’accès en caractères : char de _getdcwd_dbget wchar_tpour _wgetdcwd_dbg.

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

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, consultez errno, _doserrno, _sys_errlist et _sys_nerr.

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.

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, consultez Types de blocs 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
RoutineEn-tête requis
_getdcwd_dbg<crtdbg.h>
_wgetdcwd_dbg<crtdbg.h>

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

Environment.CurrentDirectory

_getdcwd, _wgetdcwd
Contrôle de répertoire
Versions Debug des fonctions d’Allocation du tas

Afficher: