_getcwd_dbg, _wgetcwd_dbg

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

Синтаксис

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

Параметры

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

maxlen
Максимальная длина пути в символах: char для _getcwd_dbg и wchar_t для _wgetcwd_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.

Замечания

Функции _getcwd_dbg идентичны _getcwd и _wgetcwd за исключением того, что при _DEBUG определении эти функции используют отладочную версию malloc и _malloc_dbg выделяет память, если NULL передается _wgetcwd_dbg в качестве первого параметра. Дополнительные сведения см. в разделе _malloc_dbg.

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

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

Подпрограмма Tchar.h	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_tgetcwd_dbg	_getcwd_dbg	_getcwd_dbg	_wgetcwd_dbg

Требования

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

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

См. также

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