_tempnam_dbg, _wtempnam_dbg
Версии функции _tempnam, _wtempnam, tmpnam, _wtmpnam, которые используют отладочную версию malloc, _malloc_dbg.
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и _wtempnam_dbg идентичны _tempnamи _wtempnam за исключением того, что если определен флаг _DEBUG, эти функции используют отладочную версию malloc и _malloc_dbg для выделения памяти, если NULL передается как первый параметр. Для получения дополнительной информации см. _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> |
Дополнительные сведения о совместимости см. в разделе Совместимость во введении.
Эквивалент в .NET Framework
Неприменимо. Для вызова стандартной функции C используйте PInvoke. Для получения дополнительной информации см. Примеры вызовов неуправляемого кода.
См. также
Ссылки
_tempnam, _wtempnam, tmpnam, _wtmpnam