_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 OR _NORMAL_BLOCK.

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

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

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

Возвращает указатель на buffer.A NULL возвращаемое значение указывает на ошибку. errno набор то к ENOMEM, указывающее, что недостаточно памяти для выбора maxlen байты (когда a NULL аргумент задается как buffer) или ERANGE, указывающее, что путь длиннее maxlen символы.

Дополнительные сведения см. в разделе errno, _doserrno, _sys_errlist и _sys_nerr.

Заметки

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

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

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

Требования

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

Эквивалент в .NET Framework

CurrentDirectory

См. также

Ссылки

_getcwd, _wgetcwd

Управление каталога

Основные понятия

Версии отладки функций выделения кучи