_getcwd_dbg
, _wgetcwd_dbg
Debugversionen der _getcwd
, _wgetcwd
Funktionen (nur verfügbar beim Debuggen).
Syntax
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 gibt einen Fehler an und errno
wird entweder auf ENOMEM
, der angibt, dass nicht genügend Arbeitsspeicher vorhanden ist, um Bytes zuzuweisen maxlen
(wenn ein NULL
Argument angegeben buffer
wird) oder ERANGE
, um anzugeben, dass der Pfad länger als maxlen
Zeichen ist.
Weitere Informationen finden Sie untererrno
, _doserrno
, _sys_errlist
und _sys_nerr
.
Hinweise
Die _getcwd_dbg
Funktionen und _wgetcwd_dbg
Funktionen sind identisch mit _getcwd
und _wgetcwd
mit der Ausnahme, dass diese Funktionen, wenn _DEBUG
sie definiert sind, die Debugversion von und _malloc_dbg
zum Zuweisen von malloc
Arbeitsspeicher verwenden, wenn NULL
sie 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 _CRTDBG_MAP_ALLOC
-Flag definieren. Wenn _CRTDBG_MAP_ALLOC
definiert ist, werden Aufrufe von _getcwd
und _wgetcwd
zu _getcwd_dbg
bzw. _wgetcwd_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
. Weitere Informationen finden Sie unter Blocktypen auf dem Debugheap.
Generische Textroutinenzuordnung
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.
Siehe auch
_getcwd
, _wgetcwd
Verzeichnissteuerelement
Debugversionen von Heapreservierungsfunktionen