_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

Configuration requise

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