_fullpath_dbg, _wfullpath_dbg
Versionen von _fullpath, _wfullpath, die die Debugversion von malloc zur Speicherbelegung verwenden.
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
Zeiger auf einen Puffer, der den absoluten oder vollständigen Pfadnamen enthält, oder NULL.relPath
Relativer Pfadname.maxLength
Maximale Länge des Puffers des absoluten Pfadnamens (absPath). Die Länge wird für _fullpath in Bytes ausgedrückt, aber für _wfullpath in Breitzeichen (wchar_t).blockType
Angeforderter Typ des Speicherblocks: _CLIENT_BLOCK oder _NORMAL_BLOCK.filename
Zeiger zum Namen der Quelldatei, die die Zuordnung angefordert hat, oder NULL.linenumber
Zeilennummer in der Quelldatei, in der die Belegung angefordert wurde, oder NULL.
Rückgabewert
Jede Funktion gibt einen Zeiger auf einen Puffer zurück, der den absoluten Pfadnamen (absPath) enthält. Wenn ein Fehler auftritt (z. B, wenn der in relPath übergebene Wert einen Laufwerksbuchstaben enthält, der nicht gültig ist oder nicht gefunden werden kann oder wenn der erstellte absolute Pfadname (absPath) länger ist als maxLength), gibt die Funktion NULL zurück.
Hinweise
Die Funktionen _fullpath_dbg und _wfullpath_dbg sind identisch mit _fullpath und _wfullpath, außer dass bei Definition von **_**DEBUG diese Funktionen die Debugversion von malloc, _malloc_dbg verwenden, wenn NULL als erster Parameter übergeben wird. Weitere Informationen zu den Debugfunktionen von _malloc_dbg finden Sie unter _malloc_dbg.
In den meisten Fällen müssen Sie diese Funktionen nicht explizit aufrufen. Stattdessen können Sie das Flag _CRTDBG_MAP_ALLOC definieren. Wenn _CRTDBG_MAP_ALLOC definiert ist, werden Aufrufe von _fullpath und _wfullpath neu zu _fullpath_dbg bzw. _wfullpath_dbg zugeordnet, wobei blockType auf _NORMAL_BLOCK gesetzt wird. Daher müssen Sie diese Funktionen nicht explizit aufrufen, es sei denn, Sie möchten die Heapblöcke als _CLIENT_BLOCK markieren. Weitere Informationen finden Sie unter Blocktypen auf dem Debugheap.
Zuordnung generischer Textroutinen
Tchar.h-Routine |
_UNICODE und _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
---|---|---|---|
_tfullpath_dbg |
_fullpath_dbg |
_fullpath_dbg |
_wfullpath_dbg |
Anforderungen
Funktion |
Erforderlicher Header |
---|---|
_fullpath_dbg |
<crtdbg.h> |
_wfullpath_dbg |
<crtdbg.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.