_fullpath_dbg, _wfullpath_dbg
Verze _fullpath, _wfullpath využívající ladicí verze malloc přidělení paměti.
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 );
Parametry
absPath
Ukazatel na vyrovnávací paměť, který obsahuje název absolutní nebo úplná cesta nebo NULL.relPath
Název relativní cesty.maxLength
Maximální délka názvu absolutní cesta vyrovnávací paměti (absPath).Se délka v bajtech pro _fullpath , ale v široké znaky (wchar_t) pro _wfullpath.blockType
Požadovaný typ bloku paměti: _CLIENT_BLOCK nebo _NORMAL_BLOCK.filename
Ukazatel na název zdrojového souboru, který požadovanou operaci přidělení nebo NULL.linenumber
Číslo řádku na zdrojový soubor, kde byla požadována operace přidělení nebo NULL.
Vrácená hodnota
Každá funkce vrací ukazatel na vyrovnávací paměť obsahující absolutní cesta (absPath).Pokud dojde k chybě (například v případě, že hodnota předaná v relPath zahrnuje písmeno jednotky, která není platná nebo nebyla nalezena, nebo pokud délka názvu vytvořený absolutní cestu (absPath) je větší než maxLength) vrátí funkce NULL.
Poznámky
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.Informace o ladění funkce _malloc_dbg, naleznete v části _malloc_dbg.
Chcete-li tyto funkce volat explicitně ve většině případů nepotřebujete.Namísto toho můžete definovat _CRTDBG_MAP_ALLOC příznak.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.Tedy není nutné explicitně volat tyto funkce, pokud chcete označit bloky haldy jako _CLIENT_BLOCK.Další informace naleznete v tématu typy bloky haldy ladění.
Mapování rutin obecného textu
Rutina Tchar.h |
_UNICODE a _MBCS nejsou definovány. |
_MBCS definováno |
_UNICODE definováno |
|---|---|---|---|
_tfullpath_dbg |
_fullpath_dbg |
_fullpath_dbg |
_wfullpath_dbg |
Požadavky
Funkce |
Požadovaný hlavičkový soubor |
|---|---|
_fullpath_dbg |
< crtdbg.h > |
_wfullpath_dbg |
< crtdbg.h > |
Další informace o kompatibilitě, podívejte se na téma Kompatibilita v zavedení.