_tempnam_dbg, _wtempnam_dbg

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

Requisitos

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