Freigeben über

_fullpath_dbg, _wfullpath_dbg

  • Artikel

Versionen von _fullpath, _wfullpath die die Debugversion verwenden malloc , um Arbeitsspeicher zuzuweisen.

Syntax

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_dbg in Bytes ausgedrückt, aber für wchar_t in Breitzeichen (_wfullpath_dbg).

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 vorliegt (z. B. wenn der übergebene relPath Wert einen ungültigen Laufwerkbuchstaben enthält oder nicht gefunden werden kann, oder wenn die Länge des erstellten absoluten Pfadnamens (absPath) größer als maxLengthist), gibt die Funktion zurück NULL.

Hinweise

Die _fullpath_dbg Funktionen und _wfullpath_dbg Funktionen sind identisch mit _fullpath und _wfullpath außer dass diese Funktionen, wenn _DEBUG definiert, die Debugversion von malloc, _malloc_dbgverwenden, um Speicher zuzuweisen, wenn NULL als erster Parameter übergeben wird. Informationen zu den Debugfeatures 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 _CRTDBG_MAP_ALLOC-Flag definieren. Wenn _CRTDBG_MAP_ALLOC definiert ist, werden Aufrufe von _fullpath und _wfullpath zu _fullpath_dbg bzw. _wfullpath_dbg neu zugeordnet, wobei blockType auf _NORMAL_BLOCK festgelegt wird. Daher müssen Sie diese Funktionen nicht explizit aufrufen, es sei denn, Sie möchten die Heapblöcke als _CLIENT_BLOCK. Weitere Informationen finden Sie unter Blocktypen auf dem Debugheap.

Mapping 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.

Siehe auch

Dateibehandlung
_fullpath, _wfullpath
Debugversionen von Heapreservierungsfunktionen