_fullpath_dbg, _wfullpath_dbg

Artigo
02/25/2013

Versões do _fullpath, _wfullpath que usam a versão de depuração malloc ao alocar memória.

char *_fullpath_dbg( 
   char *absPath,
   const char *relPath,
   size_t maxLength,
   int blockType,
   const char *filename,
   int linenumber 
);
wchar_t *_wfullpath_dbg( 
   wchar_t *absPath,
   const wchar_t *relPath,
   size_t maxLength,
   int blockType,
   const char *filename,
   int linenumber 
);

Parâmetros

absPath
Ponteiro para um buffer que contém o nome de caminho absoluto ou completo, ou NULL.
relPath
Nome de caminho relativo.
maxLength
Comprimento máximo do buffer de nome de caminho absoluto (absPath).Esse comprimento é em bytes para _fullpath , mas em caracteres extensos (wchar_t) para _wfullpath.
blockType
Solicitou um tipo de bloco de memória: _CLIENT_BLOCK ou _NORMAL_BLOCK.
filename
Ponteiro para o nome do arquivo de origem que solicitou a operação de alocação ou NULL.
linenumber
O número no arquivo de origem onde a operação de alocação foi solicitada de linha ou NULL.

Valor de retorno

Cada função retorna um ponteiro para um buffer que contém o nome de caminho absoluto (absPath).Se houver um erro (por exemplo, se o valor passado relPath inclui uma letra de unidade que não é válido ou não for encontrada, ou se o comprimento do nome do caminho absoluto criado (absPath) é maior do que maxLength) a função retornará NULL.

Comentários

O _fullpath_dbg e _wfullpath_dbg funções são idênticas às _fullpath e _wfullpath , exceto que, quando **_**DEBUGé definida, essas funções usam a versão de depuração malloc, _malloc_dbg, alocar memória se NULL for passado como o primeiro parâmetro.Para obter informações sobre os recursos de depuração do _malloc_dbg, consulte _malloc_dbg.

Você não precisará chamar essas funções explicitamente na maioria dos casos.Em vez disso, você pode definir a _CRTDBG_MAP_ALLOC sinalizador.When _CRTDBG_MAP_ALLOCis defined, calls to _fullpath and _wfullpathare remapped to _fullpath_dbg and _wfullpath_dbg, respectively, with the blockType set to _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

Rotina de TCHAR.h	_ Unicode e _ MBCS do arquivo não definido	_ MBCS do arquivo definido	_ Unicode definido
_tfullpath_dbg	_fullpath_dbg	_fullpath_dbg	_wfullpath_dbg

Requisitos

Função	Cabeçalho necessário
_fullpath_dbg	<crtdbg.h>
_wfullpath_dbg	<crtdbg.h>

Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.

Equivalência do .NET Framework

Create

Consulte também

Referência

Manipulação de arquivos

_fullpath, _wfullpath

Conceitos

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

Compartilhar via