Данная статья переведена автоматически. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст. Дополнительные сведения.

Перевод

Текст оригинала

Эта тема еще не получила оценку - Оценить эту тему

_fullpath_dbg, _wfullpath_dbg

Visual Studio 2012

Другие версии

Версии _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. Дополнительные сведения см. в разделе Типы блоков в куче отладки.