_getcwd_dbg, _wgetcwd_dbg

Debuguj _getcwdwersje funkcji , _wgetcwd (dostępne tylko podczas debugowania).

Składnia

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 magazynu dla ścieżki.

maxlen
Maksymalna długość ścieżki w znakach: char for _getcwd_dbg i wchar_t dla _wgetcwd_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

Zwraca wskaźnik do buffer. NULL Wartość zwracana wskazuje błąd i errno jest ustawiona na ENOMEMwartość , wskazując, że za mało pamięci do przydzielenia maxlen bajtów (gdy NULL argument jest podany jako buffer), lub na ERANGEwartość , wskazując, że ścieżka jest dłuższa niż maxlen znaki.

Aby uzyskać więcej informacji, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.

Uwagi

_getcwd_dbg Funkcje i _wgetcwd_dbg są identyczne z _getcwd funkcjami i _wgetcwd z tą różnicą, że gdy _DEBUG jest zdefiniowana, te funkcje używają wersji malloc debugowania i _malloc_dbg do przydzielania pamięci, jeśli NULL jest przekazywany jako pierwszy parametr. Aby uzyskać więcej informacji, 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 _getcwd i _wgetcwd są odpowiednio mapowane na _getcwd_dbg wartości i _wgetcwd_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.

Mapowanie rutynowego tekstu ogólnego

Procedura tchar.h	_UNICODE i _MBCS niezdefiniowane	_MBCS zdefiniowany	_UNICODE zdefiniowany
_tgetcwd_dbg	_getcwd_dbg	_getcwd_dbg	_wgetcwd_dbg

Wymagania

Procedura	Wymagany nagłówek
_getcwd_dbg	<crtdbg.h>
_wgetcwd_dbg	<crtdbg.h>

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

Zobacz też

_getcwd, _wgetcwd
Kontrolka katalogu
Wersja debugowania funkcji alokacji sterty