_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

Anforderungen

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

.NET Framework-Entsprechung

Create

Siehe auch

Referenz

Dateibehandlung

_fullpath, _wfullpath

Konzepte

Debugversionen von Heapreservierungsfunktionen