%>

使用 malloc 调试版本分配内存的 _fullpath _wfullpath 版本。

语法

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
);

参数

absPath
指向包含绝对路径名称或完整路径名称的缓冲区的指针或 NULL。

relPath
相对路径名称。

maxLength
绝对路径名称缓冲区 (absPath) 的最大长度。 对于 _fullpath_dbg，此长度以字节为单位，但是对于 wchar_t，此长度以宽字符 (_wfullpath_dbg) 为单位。

blockType
内存块的请求类型：_CLIENT_BLOCK 或 _NORMAL_BLOCK。

filename
指向已请求分配操作的源文件名的指针或 NULL。

linenumber
请求分配操作所在的源文件中的行数或 NULL。

返回值

每个函数都会返回指向包含绝对路径名称 (absPath) 的缓冲区的指针。 如果存在错误（例如，如果在 relPath 中传递的值包含一个无效或无法找到的驱动器号，或者创建的绝对路径名称 [absPath] 的长度大于 maxLength），该函数将返回 NULL。

备注

_fullpath_dbg 和 _wfullpath_dbg 函数与 _fullpath 和 _wfullpath 完全相同，只是当定义 _DEBUG 时，如果将 NULL 作为第一个参数进行传递，则这些函数将使用 malloc 的调试版本和 _malloc_dbg 来分配内存。 有关 _malloc_dbg 的调试功能的信息，请参阅 _malloc_dbg。

在大多数情况下，无需显式调用这些函数。 可以改为定义 _CRTDBG_MAP_ALLOC 标志。 定义 _CRTDBG_MAP_ALLOC 后，对 _fullpath 和 _wfullpath 的调用将分别重新映射到 _fullpath_dbg 和 _wfullpath_dbg，同时会将 blockType 设置为 _NORMAL_BLOCK。 因此，无需显式调用这些函数，除非你希望将堆块标记为 _CLIENT_BLOCK。 有关详细信息，请参阅调试堆的块类型。

一般文本例程映射

Tchar.h 例程	_UNICODE 和 _MBCS 未定义	_MBCS 已定义	_UNICODE 已定义
_tfullpath_dbg	_fullpath_dbg	_fullpath_dbg	_wfullpath_dbg

要求

函数	必需的标头
_fullpath_dbg	<crtdbg.h>
_wfullpath_dbg	<crtdbg.h>

有关兼容性的详细信息，请参阅 兼容性。

另请参阅

文件处理
%>
堆分配函数的调试版本