_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 bufferzurü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 bufferwird) oder ERANGE, um anzugeben, dass der Pfad länger als maxlen Zeichen ist.

Weitere Informationen finden Sie untererrno, _doserrno, _sys_errlistund _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