_getcwd_dbg, _wgetcwd_dbg

Article
03/04/2013

Versions debug des fonctions du _getcwd, _wgetcwd (uniquement disponibles pendant le débogage).

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 d'accès.
maxlen
Longueur maximale du chemin d'accès dans les 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 ou NULLd'allocation.
linenumber
Numéro de ligne dans le fichier source où l'opération d'allocation a été demandée ni NULL.

Valeur de retour

Retourne un pointeur vers buffer.Une valeur de retour d' NULL indique une erreur, et errno est soit définis à ENOMEM, indiquant que la mémoire insuffisante pour allouer des octets d' maxlen (lorsqu'un argument d' NULL donné comme buffer), ou à ERANGE, indiquant que le chemin d'accès est plus long que des caractères d' maxlen .

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

Notes

Les fonctions d' _getcwd_dbg et d' _wgetcwd_dbg sont identiques à _getcwd et à _wgetcwd mais, lorsque le _DEBUG est défini, ces fonctions utilisent la version debug d' malloc et d' _malloc_dbg pour allouer de la mémoire si NULL est passé comme 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 la balise d' _CRTDBG_MAP_ALLOC .Lorsque _CRTDBG_MAP_ALLOC est défini, les appels à _getcwdet l' _wgetcwdsont remappés à_getcwd_dbget à _wgetcwd_dbg, respectivement, avec blockType défini à _NORMAL_BLOCK.Ainsi, 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

routine de Tchar.h	_UNICODE et _MBCS non définis	_MBCS défini	_UNICODE défini
_tgetcwd_dbg	_getcwd_dbg	_getcwd_dbg	_wgetcwd_dbg

Configuration requise

routine	en-tête requis
_getcwd_dbg	<crtdbg.h>
_wgetcwd_dbg	<crtdbg.h>

Pour plus d'informations de compatibilité, consultez Compatibilité dans l'introduction.

Équivalent .NET Framework

CurrentDirectory

Voir aussi

Référence

_getcwd, _wgetcwd

Contrôle de répertoire

Concepts

Versions Debug des fonctions d'allocation du tas

Partager via