_tempnam_dbg, _wtempnam_dbg

Versões de função de _tempnam, _wtempnam, tmpnam, _wtmpnam que usam a versão de depuração de malloc, _malloc_dbg.

Sintaxe

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
);

Parâmetros

dir
O caminho usado no nome do arquivo se não houver nenhuma variável de ambiente TMP ou se TMP não for um diretório válido.

prefix
A cadeia de caracteres que será pré-anexada a nomes retornados pelo _tempnam.

blockType
Tipo solicitado de bloco de memória: _CLIENT_BLOCK ou _NORMAL_BLOCK.

filename
Nome do ponteiro do arquivo de origem que solicitou a operação de alocação ou NULL.

linenumber
Número da linha no arquivo de origem em que a operação de alocação foi solicitada ou NULL.

Valor retornado

Cada função retorna um ponteiro para o nome gerado ou NULL se houver uma falha. A falha pode ocorrer se houver um nome de diretório inválido especificado na variável de ambiente TMP e no dir parâmetro.

Observação

free (ou free_dbg) não precisa ser chamado para ponteiros alocados por _tempnam_dbg e _wtempnam_dbg.

Comentários

As _tempnam_dbg funções and _wtempnam_dbg são idênticas e _wtempnam _tempnam exceto que, quando _DEBUG é definida, essas funções usam a versão de depuração de malloc e _malloc_dbg, para alocar memória se NULL for passado como o primeiro parâmetro. Para obter mais informações, consulte _malloc_dbg.

Você não precisa chamar essas funções explicitamente na maioria dos casos. Em vez disso, você pode definir o sinalizador _CRTDBG_MAP_ALLOC. Quando _CRTDBG_MAP_ALLOC é definido, as chamadas a _tempnam e _wtempnam são remapeadas para _tempnam_dbg e _wtempnam_dbg, respectivamente, com o blockType definido como _NORMAL_BLOCK. Portanto, você não precisa chamar essas funções explicitamente, a menos que queira marcar os blocos de heap como _CLIENT_BLOCK. Para obter mais informações, consulte Tipos de blocos no heap de depuração.

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_ttempnam_dbg	_tempnam_dbg	_tempnam_dbg	_wtempnam_dbg

Requisitos

Rotina	Cabeçalho necessário
_tempnam_dbg, _wtempnam_dbg	<crtdbg.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

_tempnam, _wtempnam, tmpnam, _wtmpnam
E/S de fluxo
Versões de depuração das funções de alocação de heap