_fullpath_dbg, _wfullpath_dbg

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

Sintaxe

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 contendo o nome de caminho absoluto ou completo, ou NULL.

relPath
Nome de caminho relativo.

maxLength
Comprimento máximo do buffer do nome de caminho absoluto (absPath). Esse comprimento é em bytes para _fullpath_dbg mas em caracteres largos (wchar_t) para _wfullpath_dbg.

blockType
Tipo solicitado 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
Número da linha no arquivo de origem em que a operação de alocação foi solicitada ou NULL.

Valor retornado

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

Comentários

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

Você não precisa chamar essas funções explicitamente na maioria dos casos. Em vez disso, você pode definir o sinalizador _CRTDBG_MAP_ALLOC. Quando _CRTDBG_MAP_ALLOC é definido, as chamadas a _fullpath e _wfullpath são remapeadas para _fullpath_dbg e _wfullpath_dbg, respectivamente, com o blockType definido como _NORMAL_BLOCK. Portanto, você não precisa chamar essas funções explicitamente, a menos que queira marcar os blocos de heap como _CLIENT_BLOCK. Para obter mais informações, consulte Tipos de blocos no heap de depuração.

Mapeamentos de rotina de texto genérico

Rotina Tchar.h	_UNICODE e _MBCS não definidos	_MBCS 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 informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Manipulação de arquivos
_fullpath, _wfullpath
Versões de depuração das funções de alocação de heap