_fullpath_dbg, _wfullpath_dbg
Versões do _fullpath, _wfullpath que usam a versão de depuração de malloc para 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 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 mas em caracteres largos (wchar_t) para _wfullpath.blockType
Tipo de bloco de memória solicitado: _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 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 um buffer contendo o nome de caminho absoluto (absPath). Se houver um erro (por exemplo, se o valor transmitido em relPath incluir uma letra da unidade que não seja válida e não possa ser localizada, ou se o comprimento do nome de caminho absoluto criado (absPath) for maior que maxLength), a função retornará NULL.
Comentários
As funções _fullpath_dbg e _wfullpath_dbg são idênticas a _fullpath e _wfullpath. A única diferença é 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 apresentado como primeiro parâmetro. Para obter informações sobre os recursos de depuração de _malloc_dbg, consulte _malloc_dbg.
Na maioria dos casos, não é necessário chamar essas funções explicitamente. 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. 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 |
|---|---|---|---|
_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 sobre compatibilidade, consulte Compatibilidade na Introdução.