_getcwd_dbg, _wgetcwd_dbg
Debugowanie wersje _getcwd, _wgetcwd funkcji (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 magazynu dla ścieżki.maxlen
Maksymalna długość ścieżki w formie znaków: char dla _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 żądał operacji alokacji lub NULL.linenumber
Numer w pliku źródłowym, której zażądano operacji alokacji wiersza lub NULL.
Wartość zwracana
Zwraca wskaźnik do buffer.Element NULL zwracana wartość wskazuje błąd, i errno ma ustawioną opcję ENOMEM, wskazująca, że jest za mało pamięci, aby przydzielić maxlen bajtów (po NULL argument jest podawana jako buffer), albo na ERANGE, wskazującą, czy ścieżka jest dłuższy niż maxlen znaków.
Aby uzyskać więcej informacji, zobacz errno, _doserrno, _sys_errlist, and _sys_nerr.
Uwagi
_getcwd_dbg i _wgetcwd_dbg funkcje są takie same jak _getcwd i _wgetcwd z tą różnicą, że, jeśli _DEBUG jest zdefiniowany, użyj tych funkcji wersji debugowania malloc i _malloc_dbg przydzielić pamięci, jeśli NULL jest przekazywany jako pierwszym parametrem.Aby uzyskać więcej informacji, zobacz _malloc_dbg.
Nie należy wywoływać te funkcje jawnie 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łać tych funkcji, jeśli nie chcesz oznaczyć jako bloki stosu _CLIENT_BLOCK.Aby uzyskać więcej informacji, zobacz typów bloków na debugowanie stosu.
Mapowania procedur zwykłego tekstu
Procedura tchar.h |
_UNICODE i _MBCS niezdefiniowane |
_MBCS zdefiniowano |
_UNICODE zdefiniowano |
|---|---|---|---|
_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ść we wprowadzeniu.