_fullpath_dbg, _wfullpath_dbg
Wersje _fullpath, _wfullpath , użyj wersji do debugowania malloc przydzielić pamięci.
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 bufora zawierającego nazwę ścieżkę bezwzględną lub pełnego lub NULL.relPath
Nazwa ścieżki względnej.maxLength
Maksymalna długość buforu nazwy ścieżki bezwzględnej (absPath).Ta długość jest w bajtach dla _fullpath , ale w szerokości znaków (wchar_t) dla _wfullpath.blockType
Żądanie typu blok 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 w pliku źródłowym, jeżeli zażądano operacji alokacji lub NULL.
Wartość zwracana
Każda funkcja zwraca wskaźnik do bufora zawierającego nazwę ścieżki bezwzględnej (absPath).Jeśli błąd (na przykład, jeśli wartość przekazana w relPath zawiera litery dysku, która nie jest prawidłowy lub nie można znaleźć, lub jeśli długość nazwy utworzone ścieżki bezwzględnej (absPath) jest większa niż maxLength) funkcja zwraca NULL.
Uwagi
_fullpath_dbg i _wfullpath_dbg funkcje są identyczne z _fullpath i _wfullpath z wyjątkiem, gdy **_**DEBUGjest zdefiniowany, funkcje te korzystają z wersji do debugowania malloc, _malloc_dbg, aby przydzielić pamięci, jeśli wartość NULL jest przekazywany jako pierwszy parametr.Aby uzyskać informacje dotyczące debugowania cechy _malloc_dbg, zobacz _malloc_dbg.
Nie trzeba jawnie wywoływać te funkcje w większości przypadków.Zamiast tego można zdefiniować _CRTDBG_MAP_ALLOC flagi.When _CRTDBG_MAP_ALLOCis defined, calls to _fullpath and _wfullpathare remapped to _fullpath_dbg and _wfullpath_dbg, respectively, with the blockType set to _NORMAL_BLOCK.Dzięki temu, nie trzeba jawnie wywoływać te funkcje, chyba że chcesz oznaczyć bloki sterty jako _CLIENT_BLOCK.Aby uzyskać więcej informacji, zobacz Typy bloki na stercie debugowania.
Tekst rodzajowy rutynowych mapowania
Procedura TCHAR.h |
_UNICODE i _MBCS nie zdefiniowane |
_MBCS, definicja |
_UNICODE, definicja |
|---|---|---|---|
_tfullpath_dbg |
_fullpath_dbg |
_fullpath_dbg |
_wfullpath_dbg |
Wymagania
Funkcja |
Wymaganego nagłówka |
|---|---|
_fullpath_dbg |
<crtdbg.h> |
_wfullpath_dbg |
<crtdbg.h> |
Informacji dotyczących zgodności, zobacz Zgodność we wprowadzeniu.