_fullpath_dbg, _wfullpath_dbg

Статья
02/20/2013

Версии _fullpath, _wfullpath эта использование отладочная версия malloc выделить память.

char *_fullpath_dbg( 
   char *absPath,
   const char *relPath,
   size_t maxLength,
   int blockType,
   const char *filename,
   int linenumber 
);
wchar_t *_wfullpath_dbg( 
   wchar_t *absPath,
   const wchar_t *relPath,
   size_t maxLength,
   int blockType,
   const char *filename,
   int linenumber 
);

Параметры

absPath
Указатель на буфер, содержащий абсолютный или имя полного пути или NULL.
relPath
Имя относительного пути.
maxLength
Максимальная длина буфера абсолютного пути (имяabsPath).Эта длина в байтах для _fullpath но в символах (расширенныхwchar_t) _wfullpath.
blockType
Запрошенный тип блока памяти. _CLIENT_BLOCK OR _NORMAL_BLOCK.
filename
Указатель на имя исходного файла, запросившего операцию распределения или NULL.
linenumber
Номер линии в исходном файле, в котором было запрошено или операции выделения памяти NULL.

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

Каждая функция возвращает указатель на буфер, содержащий абсолютный путь (absPath).Если ошибка (например, если значение, передаваемое в пределах relPath содержит букву диска, недопустима или не может быть найдена или если длина абсолютного пути (созданного имени,absPathбольше maxLengthфункция получает) NULL.

Заметки

_fullpath_dbg и _wfullpath_dbg функции идентичны _fullpath и _wfullpath за исключением того, что, когда **_**DEBUGопределяет, эти функции использовать версию отладки malloc" _malloc_dbg, если выделение памяти в качестве первого параметра передается значение NULL.Дополнительные сведения о функциях отладки _malloc_dbgсм. _malloc_dbg.

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

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

Подпрограмма Tchar.h	Не указанные _UNICODE и _MBCS	Указанный символ _MBCS	Указанный _UNICODE
_tfullpath_dbg	_fullpath_dbg	_fullpath_dbg	_wfullpath_dbg

Требования

Функция	Обязательный заголовок
_fullpath_dbg	<crtdbg.h>
_wfullpath_dbg	<crtdbg.h>

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

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

Create

См. также

Ссылки

Обработка файла

_fullpath, _wfullpath

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

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

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