_getdcwd_dbg, _wgetdcwd_dbg

Debugversionen der _getdcwd, _wgetdcwd Funktionen (nur verfügbar beim Debuggen).

Syntax

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_dbg und wchar_t für _wgetdcwd_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 _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. Weitere Informationen finden Sie unter Blocktypen auf dem Debugheap.

Mapping 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.

Siehe auch

_getdcwd, _wgetdcwd
Verzeichnissteuerelement
Debugversionen von Heapreservierungsfunktionen