_getdcwd_dbg, _wgetdcwd_dbg
Debug wersje _getdcwd, _wgetdcwd funkcje (dostępne tylko podczas debugowania).
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 stacji dysków.buffer
Lokalizacja przechowywania dla ścieżki.maxlen
Maksymalna długość ścieżki w znakach: char do _getdcwd_dbgi wchar_tdo _wgetdcwd_dbg.blockType
Żądanie typu blok pamięci: _CLIENT_BLOCKlub _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
_getdcwd_dbg i _wgetdcwd_dbg funkcje są identyczne z _getdcwd i _wgetdcwd 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 buffer parametru.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.Gdy _CRTDBG_MAP_ALLOC jest zdefiniowany, wzywa do _getdcwd i _wgetdcwd są mapowane ponownie do _getdcwd_dbg i _wgetdcwd_dbg, odpowiednio, z blockType ustawiona na _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 |
|---|---|---|---|
_tgetdcwd_dbg |
_getdcwd_dbg |
_getdcwd_dbg |
_wgetdcwd_dbg |
Wymagania
Rozpoczęto wykonywanie procedury |
Wymaganego nagłówka |
|---|---|
_getdcwd_dbg |
<crtdbg.h> |
_wgetdcwd_dbg |
<crtdbg.h> |
Informacji dotyczących zgodności, zobacz Zgodność we wprowadzeniu.