_getdcwd_dbg, _wgetdcwd_dbg
Ladicí verze _getdcwd, _wgetdcwd funkce (k dispozici pouze při ladění).
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
Název diskové jednotky.buffer
Umístění úložiště pro danou cestu.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
Ukazatel na název zdrojového souboru, který požadovanou operaci přidělení nebo NULL.linenumber
Číslo řádku na zdrojový soubor, kde byla požadována operace přidělení nebo NULL.
Vrácená hodnota
Vrací ukazatel na parametr buffer.Vrácená hodnota NULL označuje chybu a parametr errno je nastaven buď na hodnotu ENOMEM označující nedostatek paměti k přidělení maxlen bajtů (pokud je předána hodnota NULL parametru buffer), nebo na hodnotu ERANGE označující, že cesta je delší než maxlen znaků.Další informace naleznete v tématu errno, _doserrno, _sys_errlist, and _sys_nerr.
Poznámky
_getdcwd_dbg a _wgetdcwd_dbg funkce jsou shodné s _getdcwd a _wgetdcwd s tím rozdílem, že, když _DEBUG je definována, použijte tyto funkce ladění verzi malloc a _malloc_dbg přidělení paměti, pokud NULL je předán jako buffer parametru.Další informace naleznete v tématu _malloc_dbg.
Chcete-li tyto funkce volat explicitně ve většině případů nepotřebujete.Namísto toho můžete definovat _CRTDBG_MAP_ALLOC příznak.Při _CRTDBG_MAP_ALLOC je definován, zavolá na _getdcwd a _wgetdcwd jsou mapovány na _getdcwd_dbg a _wgetdcwd_dbg, resp. s blockType nastavena na _NORMAL_BLOCK.Tedy není nutné explicitně volat tyto funkce, pokud chcete označit bloky haldy jako _CLIENT_BLOCK.Další informace naleznete v tématu typy bloky haldy ladění.
Mapování rutin obecného textu
Rutina Tchar.h |
_UNICODE a _MBCS nejsou definovány. |
_MBCS definováno |
_UNICODE definováno |
|---|---|---|---|
_tgetdcwd_dbg |
_getdcwd_dbg |
_getdcwd_dbg |
_wgetdcwd_dbg |
Požadavky
Rutina |
Požadovaný hlavičkový soubor |
|---|---|
_getdcwd_dbg |
< crtdbg.h > |
_wgetdcwd_dbg |
< crtdbg.h > |
Další informace o kompatibilitě, podívejte se na téma Kompatibilita v zavedení.