_fullpath_dbg, _wfullpath_dbg
Versionen von _fullpath, _wfullpath , die die Debugversion von malloc verwenden, um Speicher belegen.
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
);
Parameter
absPath
Ein Zeiger auf einen Puffer, der die absolute oder den vollständigen Pfadnamen enthält, oder NULL.relPath
Der relative Pfad.maxLength
Maximale Länge des absoluten Pfadnamenpuffers (absPath).Diese Länge ist in Bytes für _fullpath aber in Breitzeichen (wchar_t) für _wfullpath.blockType
Angeforderter Typ des Speicherblocks: _CLIENT_BLOCK oder _NORMAL_BLOCK.filename
Ein Zeiger auf den Namen der Quelldatei, die NULLoder - Vorgang Zuordnungen angefordert hat.linenumber
Zeilennummer in der Quelldatei, in der der Vorgang NULLoder Zuordnungen angefordert wurde.
Rückgabewert
Jede Funktion gibt einen Zeiger auf einen Puffer zurück, der den absoluten Pfadnamen (absPath) enthält.Wenn ein Fehler vorliegt (z. B. wenn der Wert, der in relPath übergeben wird, einen Laufwerkbuchstaben enthält, der ungültig ist oder nicht gefunden werden kann oder wenn die Länge des erstellten absoluten Pfadnamens (absPath) größer als der, maxLength) die Funktion zurückgibt NULL.
Hinweise
Die _fullpath_dbg und _wfullpath_dbg-Funktionen sind in _fullpath und _wfullpath identisch, mit der Ausnahme, dass beim **_**DEBUGdefiniert wird, verwenden diese Funktionen die Debugversion von malloc, _malloc_dbg, um Speicher belegen wenn NULL als erster Parameter übergeben wird.Weitere Informationen über die Debugfunktionen aus _malloc_dbgfinden Sie unter _malloc_dbg.
Sie müssen diese Funktionen in den meisten Fällen nicht explizit aufrufen.Stattdessen können Sie das Flag _CRTDBG_MAP_ALLOC definieren.Wenn _CRTDBG_MAP_ALLOCdefiniert wird, werden Aufrufe _fullpath und _wfullpathzu _fullpath_dbg und _wfullpath_dbgwenn blockType jeweils neu zugeordnet _NORMAL_BLOCKzu festgelegt ist.Daher ist es nicht erforderlich, um diese Funktionen explizit aufrufen, sofern der Heap als Bausteine _CLIENT_BLOCKkennzeichnen möchten.Weitere Informationen finden Sie unter Blocktypen auf dem Debugheap.
Zuweisung generischer Textroutinen
Tchar.h-Routine |
_UNICODE als auch _MBCS nicht definiert |
_MBCS definieren |
_UNICODE definiert |
|---|---|---|---|
_tfullpath_dbg |
_fullpath_dbg |
_fullpath_dbg |
_wfullpath_dbg |
Anforderungen
Funktion |
Erforderlicher Header |
|---|---|
_fullpath_dbg |
<crtdbg.h> |
_wfullpath_dbg |
<crtdbg.h> |
Weitere Informationen finden Sie unter Kompatibilität Kompatibilität in der Einführung.