_getcwd_dbg, _wgetcwd_dbg
Debug wersje _getcwd, _wgetcwd funkcje (dostępne tylko podczas debugowania).
char *_getcwd_dbg(
char *buffer,
int maxlen,
int blockType,
const char *filename,
int linenumber
);
wchar_t *_wgetcwd_dbg(
wchar_t *buffer,
int maxlen,
int blockType,
const char *filename,
int linenumber
);
Parametry
buffer
Lokalizacja przechowywania dla ścieżki.maxlen
Maksymalna długość ścieżki w znakach: char do _getcwd_dbg i wchar_t do _wgetcwd_dbg.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
Zwraca wskaźnik do buffer.A NULL zwracana wartość wskazuje błąd, i errno jest ustawiona albo na ENOMEM, wskazując, że jest za mało pamięci, aby przydzielić maxlen bajtów (po NULL argument jest podawany jako buffer), lub ERANGE, wskazujące, że ścieżka jest dłuższa niż maxlen znaków.
Aby uzyskać więcej informacji, zobacz errno, _doserrno, _sys_errlist i _sys_nerr.
Uwagi
_getcwd_dbg i _wgetcwd_dbg funkcje są identyczne z _getcwd i _wgetcwd z wyjątkiem, gdy _DEBUG jest zdefiniowany, funkcje te korzystają z wersji do debugowania malloc i _malloc_dbg do przydzielania pamięci, jeśli NULL jest przekazywana jako pierwszy parametr.Aby uzyskać więcej informacji, 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_ALLOC is defined, calls to _getcwdand _wgetcwdare remapped to _getcwd_dbgand _wgetcwd_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 |
|---|---|---|---|
_tgetcwd_dbg |
_getcwd_dbg |
_getcwd_dbg |
_wgetcwd_dbg |
Wymagania
Rozpoczęto wykonywanie procedury |
Wymaganego nagłówka |
|---|---|
_getcwd_dbg |
<crtdbg.h> |
_wgetcwd_dbg |
<crtdbg.h> |
Informacji dotyczących zgodności, zobacz Zgodność we wprowadzeniu.