_getdcwd_dbg, _wgetdcwd_dbg

Статья
02/20/2013

Отладочные версии _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_BLOCKOR _NORMAL_BLOCK.
filename
Указатель на имя исходного файла, запросившего операцию распределения или NULL.
linenumber
Номер линии в исходном файле, в котором было запрошено или операции выделения памяти NULL.

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

Возвращает указатель на buffer.A NULL возвращаемое значение указывает на ошибку. errno набор то к ENOMEM, указывающее, что недостаточно памяти для выбора maxlen байты (когда a 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.Дополнительные сведения см. в разделе Типы блоков в куче отладки.

Сопоставления подпрограммы Родов-Текста