_getcwd_dbg, _wgetcwd_dbg
Debugversionen der Funktionen _getcwd, _wgetcwd (nur während des Debuggens verfügbar).
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 );
Parameter
buffer
Speicherort für den Pfad.maxlen
Maximale Länge des Pfads in Zeichen: char für _getcwd_dbg und wchar_t für _wgetcwd_dbg.blockType
Angeforderter Typ des Speicherblocks: _CLIENT_BLOCK oder _NORMAL_BLOCK.filename
Zeiger auf den Namen der Quelldatei, die die Belegung angefordert hat, oder NULL.linenumber
Zeilennummer in der Quelldatei, in der die Belegung 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 Funktionen _getcwd_dbg und _wgetcwd_dbg sind identisch mit _getcwd und _wgetcwd, außer dass bei Definition von DEBUG diese Funktionen die Debugversion von malloc, _malloc_dbg verwenden, wenn NULL als erster 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 Flag _CRTDBG_MAP_ALLOC definieren. Wenn _CRTDBG_MAP_ALLOC definiert ist, werden Aufrufe von _getcwd und _wgetcwd zu _getcwd_dbgbzw. _wgetcwd_dbg neu zugeordnet, wobei blockType auf _NORMAL_BLOCK gesetzt 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 |
|---|---|---|---|
_tgetcwd_dbg |
_getcwd_dbg |
_getcwd_dbg |
_wgetcwd_dbg |
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_getcwd_dbg |
<crtdbg.h> |
_wgetcwd_dbg |
<crtdbg.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.