_getcwd_dbg, _wgetcwd_dbg

Versions de débogage des fonctions _getcwd, _wgetcwd (disponibles uniquement durant 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 en 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 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 _getcwd_dbg et _wgetcwd_dbg sont identiques à _getcwd et _wgetcwd sauf que, quand _DEBUG est défini, ces fonctions utilisent la version de débogage de malloc et _malloc_dbg pour allouer la mémoire si la valeur NULL est passée comme premier paramètre. 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 à _getcwdet _wgetcwdsont remappés à _getcwd_dbget _wgetcwd_dbg, respectivement, avec leblockType 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

Configuration requise

Pour plus d'informations sur la compatibilité, voir 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