_tempnam_dbg, _wtempnam_dbg

Artigo
02/25/2013

Função versões do _tempnam, _wtempnam, tmpnam, _wtmpnam que usam a versão de depuração 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 
);

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 é um diretório válido.
prefix
A seqüência de caracteres que seja antecedidos nomes retornados por _tempnam.
blockType
Solicitou um tipo de bloco de memória: _CLIENT_BLOCKou _NORMAL_BLOCK.
filename
Ponteiro para o nome do arquivo de origem que solicitou a operação de alocação ou NULL.
linenumber
Número de linha na arquivo de origem onde a operação de alocação foi solicitada ou NULL.

Valor de retorno

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

Observação
free(ou free_dbg) precisa ser chamado para ponteiros alocados pelo _tempnam_dbg e _wtempnam_dbg.

Comentários

O _tempnam_dbge _wtempnam_dbgfunções são idênticas às _tempname _wtempnam, exceto que, quando _DEBUGé definida, essas funções usam a versão de depuração malloc e _malloc_dbg, alocar memória se NULL é passado como o primeiro parâmetro.Para obter mais informações, consulte _malloc_dbg.

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

Mapeamentos de rotina de texto genérico

TCHAR.Rotina H	_ Unicode & _ MBCS do arquivo não definido	_ MBCS do arquivo 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 adicionais de compatibilidade, consulte Compatibilidade na introdução.

Equivalência do .NET Framework

Não aplicável. Para chamar a função c padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

_tempnam, _wtempnam, tmpnam, _wtmpnam

Fluxo de i/O

Conceitos

Versões de depuração de funções de alocação de Heap

Compartilhar via