_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

Requisitos

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