_getdcwd_dbg, _wgetdcwd_dbg
Debugowanie wersje _getdcwd, _wgetdcwd funkcji (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 magazynu dla ścieżki.maxlen
Maximum length of the path in characters: char for _getdcwd_dbgand wchar_tfor _wgetdcwd_dbg.blockType
Requested type of the memory block: _CLIENT_BLOCKor _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
_getdcwd_dbg i _wgetdcwd_dbg funkcje są takie same jak _getdcwd i _wgetdcwd z tą różnicą, że, kiedy _DEBUG jest zdefiniowana, użyj tych funkcji wersji debugowania malloc i _malloc_dbg przydzielić pamięci, jeśli NULL jest przekazywany jako buffer parametru.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.Gdy _CRTDBG_MAP_ALLOC jest zdefiniowany, wywołuje do _getdcwd i _wgetdcwd są mapowane ponownie do _getdcwd_dbg i _wgetdcwd_dbgodpowiednio z blockType ustawioną _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 |
|---|---|---|---|
_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ść we wprowadzeniu.