Partager via


_getdcwd_dbg, _wgetdcwd_dbg

Versions debug des fonctions du _getdcwd, _wgetdcwd (uniquement disponibles 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 d'accès.

  • maxlen
    Longueur maximale du chemin d'accès dans les 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 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' _getdcwd_dbg et d' _wgetdcwd_dbg sont identiques à _getdcwd et à _wgetdcwd mais, lorsque _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 paramètre d' 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 la balise d' _CRTDBG_MAP_ALLOC .Lorsque _CRTDBG_MAP_ALLOC est défini, les appels à _getdcwd et l' _wgetdcwd sont remappés à _getdcwd_dbg et à _wgetdcwd_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

_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 de compatibilité, consultez Compatibilité dans l'introduction.

Équivalent .NET Framework

Environment.CurrentDirectory

Voir aussi

Référence

_getdcwd, _wgetdcwd

Contrôle de répertoire

Concepts

Versions Debug des fonctions d'allocation du tas