_fullpath_dbg、_wfullpath_dbg
使用偵錯版 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 使用位元組,但針對 _wfullpath 使用寬字元 (wchar_t)。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> |
如需相容性的詳細資訊,請參閱<簡介>中的 相容性。