Udostępnij za pośrednictwem

_fullpath_dbg, _wfullpath_dbg

  • Artykuł

Wersje programu _fullpath_wfullpath, które używają wersji malloc debugowania do przydzielenia pamięci.

Składnia

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
);

Parametry

absPath
Wskaźnik do buforu zawierającego bezwzględną lub pełną nazwę ścieżki lub NULL.

relPath
Nazwa ścieżki względnej.

maxLength
Maksymalna długość buforu nazwy ścieżki bezwzględnej (absPath). Ta długość jest wyrażona w bajtach, _fullpath_dbg ale w znakach szerokich (wchar_t) dla _wfullpath_dbg.

blockType
Żądany typ bloku pamięci: _CLIENT_BLOCK lub _NORMAL_BLOCK.

filename
Wskaźnik do nazwy pliku źródłowego, który zażądał operacji alokacji lub NULL.

linenumber
Numer wiersza w pliku źródłowym, w którym zażądano operacji alokacji lub NULL.

Wartość zwracana

Każda funkcja zwraca wskaźnik do buforu zawierającego bezwzględną nazwę ścieżki (absPath). Jeśli wystąpi błąd (na przykład jeśli przekazana wartość relPath zawiera literę dysku, która nie jest prawidłowa lub nie można jej odnaleźć, lub jeśli długość utworzonej nazwy ścieżki bezwzględnej (absPath) jest większa niż maxLength) funkcja zwraca NULLwartość .

Uwagi

Funkcje _fullpath_dbg i _wfullpath_dbg są identyczne z _fullpath funkcjami i _wfullpath z tą różnicą, że gdy _DEBUG jest zdefiniowana, te funkcje używają wersji mallocdebugowania , _malloc_dbgdo przydzielenia pamięci, jeśli NULL jest przekazywany jako pierwszy parametr. Aby uzyskać informacje na temat funkcji debugowania programu _malloc_dbg, zobacz _malloc_dbg.

W większości przypadków nie trzeba jawnie wywoływać tych funkcji. Zamiast tego można zdefiniować flagę _CRTDBG_MAP_ALLOC . Po _CRTDBG_MAP_ALLOC zdefiniowaniu wywołania metody _fullpath i _wfullpath są odpowiednio mapowane na _fullpath_dbg wartości i _wfullpath_dbgz ustawioną wartością blockType _NORMAL_BLOCK. W związku z tym nie trzeba jawnie wywoływać tych funkcji, chyba że chcesz oznaczyć bloki sterty jako _CLIENT_BLOCK. Aby uzyskać więcej informacji, zobacz Typy bloków na stercie debugowania.

Mapowania procedur tekstu ogólnego

Procedura tchar.h _UNICODE i _MBCS niezdefiniowane _MBCS zdefiniowany _UNICODE zdefiniowany
_tfullpath_dbg _fullpath_dbg _fullpath_dbg _wfullpath_dbg

Wymagania

Function Wymagany nagłówek
_fullpath_dbg <crtdbg.h>
_wfullpath_dbg <crtdbg.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Zobacz też

Obsługa plików
_fullpath, _wfullpath
Wersja debugowania funkcji alokacji sterty