_tempnam_dbg, _wtempnam_dbg

Версии функций , tmpnam_wtmpnam_wtempnam использующие отладочную версию malloc, . _malloc_dbg_tempnam

Синтаксис

char *_tempnam_dbg(
   const char *dir,
   const char *prefix,
   int blockType,
   const char *filename,
   int linenumber
);
wchar_t *_wtempnam_dbg(
   const wchar_t *dir,
   const wchar_t *prefix,
   int blockType,
   const char *filename,
   int linenumber
);

Параметры

dir
Путь, используемый в имени файла, если нет переменной среды TMP или если TMP не является допустимым каталогом.

prefix
Строка, которая добавляется в начало имен, возвращаемых _tempnam.

blockType
Запрошенный тип блока памяти: _CLIENT_BLOCK или _NORMAL_BLOCK.

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

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

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

Каждая функция возвращает указатель на имя, созданное или NULL если произошел сбой. Сбой может произойти, если в переменной среды TMP и в dir параметре указан недопустимый имя каталога.

Примечание.

Не требуется вызывать free (или free_dbg) для указателей, выделенных функциями _tempnam_dbg и _wtempnam_dbg.

Замечания

Функции _tempnam_dbg идентичны _tempnam и _wtempnam за исключением того, что при _DEBUG определении эти функции используют отладочную версию malloc и _malloc_dbg, чтобы выделить память, если NULL передается _wtempnam_dbg в качестве первого параметра. Дополнительные сведения см. в разделе _malloc_dbg.

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

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

Подпрограмма TCHAR.H	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_ttempnam_dbg	_tempnam_dbg	_tempnam_dbg	_wtempnam_dbg

Требования

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

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

См. также

_tempnam, _wtempnam, tmpnam, _wtmpnam
Потоковый ввод-вывод
Версии отладки функций выделения кучи