_fullpath_dbg, _wfullpath_dbg

Artikel
02/26/2013

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