_fullpath_dbg _wfullpath_dbg

Článek
03/04/2013

Verze _fullpath _wfullpath , použít ladicí verzi 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 do vyrovnávací paměti obsahující název absolutní nebo celou cestu nebo NULL.
relPath
Název relativní cesty.
maxLength
Maximální délka vyrovnávací paměti název absolutní cesty (absPath).Tato délka je v bajtech pro _fullpath , ale v celé znaky (wchar_t) pro _wfullpath.
blockType
Typ bloku paměti požadované: _CLIENT_BLOCK nebo _NORMAL_BLOCK.
filename
Ukazatel myši na název zdrojového souboru, která požaduje přidělení operace nebo NULL.
linenumber
Číslo zdrojového souboru, kde byla požadována operace přidělení nebo NULL.

Vrácená hodnota

Každá funkce vrací ukazatel do vyrovnávací paměti obsahující název absolutní cesty (absPath).Pokud dojde k chybě (například, pokud hodnota předaná relPath obsahuje písmeno jednotky, které není platná nebo nelze nalézt nebo pokud délka názvu vytvořeného absolutní cestu (absPath) je větší než maxLength) vrátí funkce NULL.

Poznámky

_fullpath_dbg a _wfullpath_dbg funkce jsou shodné s _fullpath a _wfullpath s výjimkou, kdy **_**DEBUGje definován, tyto funkce použít ladicí verzi malloc, _malloc_dbg, přidělení paměti, pokud je jako první parametr předaný NULL.Informace o ladění funkce _malloc_dbg, viz _malloc_dbg.

Není nutné explicitně volat tyto funkce ve většině případů.Mí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 na ladění haldy.

Obecný Text rutinní mapování

Rutina Tchar.h	_UNICODE a _MBCS není definován	_MBCS, definice	_UNICODE, definice
_tfullpath_dbg	_fullpath_dbg	_fullpath_dbg	_wfullpath_dbg

Požadavky

Function	Požadované záhlaví
_fullpath_dbg	<crtdbg.h>
_wfullpath_dbg	<crtdbg.h>

Další informace o kompatibilitě v tématu Kompatibilita v úvodu.

Ekvivalent v rozhraní .NET Framework

Create

Viz také

Referenční dokumentace

Zpracování souborů

_fullpath _wfullpath

Koncepty

Ladění verze funkce přidělení haldy

Sdílet prostřednictvím