_getdcwd_dbg, _wgetdcwd_dbg
Debugversionen der _getdcwd, _wgetdcwd-Funktionen (nur während des Debuggens verfügbar).
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 );
Parameter
drive
Name des Laufwerks.buffer
Speicherort für den Pfad.maxlen
Maximale Länge des Pfads in Zeichen: char für _getdcwd_dbgund wchar_tfür _wgetdcwd_dbg.blockType
Angeforderter Typ des Speicherblocks: _CLIENT_BLOCKoder _NORMAL_BLOCK.filename
Zeiger zum Namen der Quelldatei, der die Belegung angefordert hat, oder NULL.linenumber
Zeilennummer in der Quelldatei, in der die Zuordnung angefordert wurde, oder NULL.
Rückgabewert
Gibt einen Zeiger auf buffer zurück. Ein NULL-Rückgabewert zeigt einen Fehler an, und errno wird entweder auf ENOMEM festgelegt, um anzugeben, dass nicht genügend Arbeitsspeicher zum Zuordnen von maxlen Bytes vorhanden ist (wenn ein NULL-Argument als buffer angegeben wird), oder auf ERANGE, um anzugeben, dass der Pfad länger als maxlen Zeichen ist. Weitere Informationen finden Sie unter errno, _doserrno, _sys_errlist und _sys_nerr.
Hinweise
Die _getdcwd_dbg- und _wgetdcwd_dbg-Funktionen sind identisch mit _getdcwd und _wgetdcwd, außer dass bei Definition von _DEBUG diese Funktionen die Debugversion von malloc und _malloc_dbg verwenden, um Speicher zuzuordnen, wenn NULL als buffer-Parameter übergeben wird. Weitere Informationen finden Sie unter _malloc_dbg.
In den meisten Fällen müssen Sie diese Funktionen nicht explizit aufrufen. Stattdessen können Sie das _CRTDBG_MAP_ALLOC-Flag definieren. Wenn _CRTDBG_MAP_ALLOC definiert ist, werden Aufrufe von _getdcwd und _wgetdcwd zu _getdcwd_dbg bzw. _wgetdcwd_dbg neu zugeordnet, wobei blockType auf _NORMAL_BLOCK festgelegt wird. Daher müssen Sie diese Funktionen nicht explizit aufrufen, es sei denn, Sie möchten die Heapblöcke als _CLIENT_BLOCK markieren. Weitere Informationen finden Sie unter Blocktypen auf dem Debugheap.
Zuordnung generischer Textroutinen
Tchar.h-Routine |
_UNICODE und _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
|---|---|---|---|
_tgetdcwd_dbg |
_getdcwd_dbg |
_getdcwd_dbg |
_wgetdcwd_dbg |
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_getdcwd_dbg |
<crtdbg.h> |
_wgetdcwd_dbg |
<crtdbg.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.