Поделиться через

_getdcwd_dbg, _wgetdcwd_dbg

  • Статья

Отладка версий _getdcwd_wgetdcwd функций (доступна только во время отладки).

Синтаксис

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
);

Параметры

drive
Имя диска.

buffer
Место хранения пути.

maxlen
Максимальная длина пути в символах: char для _getdcwd_dbg и wchar_t для _wgetdcwd_dbg.

blockType
Запрошенный тип блока памяти: _CLIENT_BLOCK или _NORMAL_BLOCK.

filename
Указатель на имя исходного файла, который запросил операцию выделения, или NULL.

linenumber
Номер строки в исходном файле, в которой была запрошена операция выделения, или NULL.

Возвращаемое значение

Возвращает указатель на buffer. NULL Возвращаемое значение указывает на ошибку и errno имеет ENOMEMзначение < a0/>, указывающее, что недостаточно памяти для выделения maxlen байтов (при указании аргумента NULL как buffer), либо ERANGEдля обозначения того, что путь длиннее maxlen символов. Дополнительные сведения см. в разделе errno, _doserrno, _sys_errlist, и _sys_nerr.

Замечания

Функции _getdcwd_dbg и _wgetdcwd_dbg идентичны _getdcwd и _wgetdcwd за исключением того, что если определен флаг _DEBUG, эти функции используют отладочную версию функций malloc и _malloc_dbg для выделения памяти, если NULL передается как параметр buffer. Дополнительные сведения см. в разделе _malloc_dbg.

В большинстве случаев эти функции не нужно вызывать явным образом. Вместо этого можно определить флаг _CRTDBG_MAP_ALLOC. Если определен флаг _CRTDBG_MAP_ALLOC, вызовы функций _getdcwd и _wgetdcwd повторно сопоставляются с _getdcwd_dbg и _wgetdcwd_dbg соответственно, а для параметра blockType задается флаг _NORMAL_BLOCK. Таким образом, вам не нужно явно вызывать эти функции, если вы не хотите пометить блоки кучи как _CLIENT_BLOCK. Дополнительные сведения см. в разделе Типы блоков в отладочной куче.

Сопоставления подпрограмм универсального текста

Подпрограмма Tchar.h _UNICODE и _MBCS не определен _MBCS Определенные _UNICODE Определенные
_tgetdcwd_dbg _getdcwd_dbg _getdcwd_dbg _wgetdcwd_dbg

Требования

Маршрут Обязательный заголовок
_getdcwd_dbg <crtdbg.h>
_wgetdcwd_dbg <crtdbg.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

См. также

_getdcwd, _wgetdcwd
Элемент управления каталогом
Версии отладки функций выделения кучи