_fullpath_dbg, _wfullpath_dbg

Artigo
08/25/2010

Versões de _fullpath, _wfullpath que usam a versão de depurar do 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 que contém o nome de caminho absoluto ou completo ou NULL.
relPath
Nome de caminho relativo.
maxLength
Comprimento máximo de buffer de nome de caminho absoluto (absPath). Esse comprimento é em bytes para _fullpath mas em toda a caracteres)wchar_t) para _wfullpath.
blockType
Tipo de bloco de memória solicitado: _CLIENT_BLOCK ou _NORMAL_BLOCK.
filename
Ponteiro para o nome do arquivo de fonte que solicitou a operação de alocação ou NULL.
linenumber
Linha número no arquivo de fonte em que a operação de alocação foi solicitada 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 da unidade que inválido ou inválido for encontrada, ou se o comprimento do caminho absoluto criado nome ()absPath) é maior que maxLength) a função retornará NULL.

Comentários

The _fullpath_dbg and _wfullpath_dbg functions are identical to _fullpath and _wfullpath except that, when **_**DEBUGis defined, these functions use the debug version of malloc, _malloc_dbg, to allocate memory if NULL is passed as the first parameter.Para obter informações sobre os recursos de depuração da _malloc_dbg, consulte _malloc_dbg.

Você não precisa telefonar essas funções explicitamente na maioria dos casos.Em vez disso, você pode definir o _CRTDBG_MAP_ALLOC sinalizar. 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.Portanto, não é necessário chamar essas funções explicitamente, a menos que você deseja marcar sistema autônomo blocos de heap sistema autônomo _CLIENT_BLOCK. For more information, see Tipos de blocos na heap de Depurar.

Mapeamentos de rotina de texto genérica

Rotina tchar.h	_UNICODE e _MBCS não definido	_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 de compatibilidade, consulte Compatibility na introdução.

Equivalente do NET Framework

Create

Consulte também

Conceitos

Depurar de versões de funções de alocação de heap

Referência

Manipulação de arquivos

_fullpath, _wfullpath

Partilhar via