_tempnam_dbg, _wtempnam_dbg
Versões da função do _tempnam, _wtempnam, tmpnam, _wtmpnam que usam a versão de depuração 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 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_BLOCKou _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 de retorno
Cada função retorna um ponteiro para o nome gerado ou NULL, caso tenha ocorrido uma falha. Pode ocorrer uma falha se houver um nome de diretório inválido especificado na variável de ambiente TMP e no parâmetro dir.
Dica
free (ou free_dbg) não precisa ser chamado para ponteiros alocados por _tempnam_dbg e _wtempnam_dbg.
Comentários
As funções _tempnam_dbge _wtempnam_dbgsão idênticas a _tempname _wtempnamexceto que, quando _DEBUGé definido, essas funções usam a versão de depuração de malloc e _malloc_dbg para alocar memória se NULL for enviado como primeiro parâmetro. Para obter mais informações, consulte _malloc_dbg.
Na maioria dos casos, não é necessário chamar essas funções explicitamente. Em vez disso, defina o sinalizador _CRTDBG_MAP_ALLOC. Quando _CRTDBG_MAP_ALLOC estiver definido, as chamadas para _tempnam e _wtempnam são remapeadas para _tempnam_dbg e _wtempnam_dbg, respectivamente, com blockType definido para _NORMAL_BLOCK. Assim, não é necessário chamar essas funções explicitamente, a menos que você queira marcar os blocos de heap como _CLIENT_BLOCK. Para obter mais informações, consulte Tipos de blocos na heap de depuração.
Mapeamentos da 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 adicionais sobre 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