_getdcwd_dbg, _wgetdcwd_dbg

Debuguj _getdcwdwersje funkcji , _wgetdcwd (dostępne tylko podczas debugowania).

Składnia

char *_getdcwd_dbg(
   int drive,
   char *buffer,
   int maxlen,
   int blockType,
   const char *filename,
   int linenumber
);
wchar_t *_wgetdcwd_dbg(
   int drive,
   wchar_t *buffer,
   int maxlen,
   int blockType,
   const char *filename,
   int linenumber
);

Parametry

drive
Nazwa dysku.

buffer
Lokalizacja magazynu dla ścieżki.

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

_getdcwd_dbg Funkcje i _wgetdcwd_dbg są identyczne z _getdcwd funkcjami i _wgetdcwd z tą różnicą, że gdy _DEBUG jest zdefiniowana, te funkcje używają wersji malloc debugowania i _malloc_dbg przydzielania pamięci, jeśli NULL jest przekazywany jako buffer parametr. W celu uzyskania więcej informacji, zobacz następujący temat: _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 _getdcwd i _wgetdcwd są odpowiednio mapowane na _getdcwd_dbg wartości i _wgetdcwd_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 Zdefiniowane	_UNICODE Zdefiniowane
_tgetdcwd_dbg	_getdcwd_dbg	_getdcwd_dbg	_wgetdcwd_dbg

Wymagania

Procedura	Wymagany nagłówek
_getdcwd_dbg	<Crtdbg.h>
_wgetdcwd_dbg	<Crtdbg.h>

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

Zobacz też

_getdcwd, _wgetdcwd
Kontrolka katalogu
Wersja debugowania funkcji alokacji sterty