Sdílet prostřednictvím

_getdcwd_dbg, _wgetdcwd_dbg

  • Článek

Ladění verzí _getdcwdfunkcí , _wgetdcwd (k dispozici pouze během ladění).

Syntaxe

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 cestu

maxlen
Maximální délka cesty znaků: char pro _getdcwd_dbg a wchar_t pro _wgetdcwd_dbg.

blockType
Požadovaný typ paměťového bloku: _CLIENT_BLOCK nebo _NORMAL_BLOCK.

filename
Ukazatel na název zdrojového souboru, který požadoval operaci přidělení nebo NULL.

linenumber
Číslo řádku ve zdrojovém souboru, kde byla požadována operace přidělení nebo NULL.

Vrácená hodnota

Vrací ukazatel na parametr buffer. NULL Návratová hodnota označuje chybu a errno je nastavena na ENOMEMhodnotu , která označuje, že není dostatek paměti k přidělení maxlen bajtů (pokud NULL je argument uveden jako buffer), nebo pro ERANGE, označující, že cesta je delší než maxlen znaky. Další informace naleznete v tématu errno, _doserrno, _sys_errlista _sys_nerr.

Poznámky

Funkce _getdcwd_dbg jsou _wgetdcwd_dbg identické s tím rozdílem _getdcwd _wgetdcwd , že pokud _DEBUG jsou definovány, tyto funkce používají ladicí verzi malloc a _malloc_dbg přidělují paměť, pokud NULL je předán jako buffer parametr. Další informace najdete na webu _malloc_dbg.

Ve většině případů tyto funkce nemusíte volat explicitně. Místo toho můžete příznak definovat _CRTDBG_MAP_ALLOC . Pokud _CRTDBG_MAP_ALLOC je definována, volání a _wgetdcwd _getdcwd jsou znovu namapována _getdcwd_dbg a _wgetdcwd_dbg, v uvedeném pořadí, s nastavenou na _NORMAL_BLOCKblockType . Proto není nutné tyto funkce volat explicitně, pokud nechcete označit bloky haldy jako _CLIENT_BLOCK. Další informace naleznete v tématu Typy bloků v haldě ladění.

Mapování rutin obecného textu

Rutina Tchar.h _UNICODE a _MBCS není definován _MBCS definovaný _UNICODE definovaný
_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ě najdete v tématu Kompatibilita.

Viz také

_getdcwd, _wgetdcwd
Ovládací prvek adresář
Ladění verzí funkcí přidělení haldy