_tempnam_dbg, _wtempnam_dbg

Artigo
08/25/2010

Versões da função de _tempnam, _wtempnam, tmpnam, _wtmpnam que usam a versão de depurar do 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 de arquivo se não houver nenhuma variável de ambiente TMP ou se TMP não for um diretório válido.
prefix
A seqüência de caracteres que será pré-pendente para nomes retornados por _tempnam.
blockType
Tipo de bloco de memória solicitado: _CLIENT_BLOCK ou _NORMAL_BLOCK.
filename
Ponteiro para o nome do arquivo de fonte que solicitou a operação de alocação ou NULL.
linenumber
Número da linha arquivo de fonte onde foi solicitada a operação de alocação 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 pasta inválido especificado na variável de ambiente TMP e no dir parâmetro.

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

Comentários

The _tempnam_dbgand _wtempnam_dbgfunctions are identical to _tempnamand _wtempnamexcept that, when _DEBUGis defined, these functions use the debug version of malloc and _malloc_dbg, to allocate memory if NULL is passed as the first parameter.Para obter mais informações, consulte _malloc_dbg.

Você não precisa telefonar essas funções explicitamente na maioria dos casos.Em vez disso, você pode definir o sinalizar _CRTDBG_MAP_ALLOC. Quando _CRTDBG_MAP_ALLOC é definido, chamadas para _tempnamand _wtempnamare remapped to _tempnam_dbgand _wtempnam_dbg, respectivamente, com o blockType conjunto para _NORMAL_BLOCK. Portanto, não é necessário chamar essas funções explicitamente, a menos que você deseja marcar sistema autônomo blocos de heap sistema autônomo _CLIENT_BLOCK. Para obter mais informações, consulte Tipos de blocos na heap de Depurar.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_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 adicionais compatibilidade, consulte Compatibility na introdução.

Equivalente do NET Framework

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

Consulte também

Conceitos

Depurar de versões de funções de alocação de heap

Referência

_tempnam, _wtempnam, tmpnam, _wtmpnam

Fluxo de E/S

Partilhar via