_getcwd_dbg, _wgetcwd_dbg
Debugversionen der _getcwd, _wgetcwd-Funktionen (Debug) als nur 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 in Zeichen des Pfads: char für _getcwd_dbg und wchar_t für _wgetcwd_dbg.blockType
Angeforderter Typ des Speicherblocks: _CLIENT_BLOCK oder _NORMAL_BLOCK.filename
Ein Zeiger auf den Namen der Quelldatei, die den Vorgang für Zuordnungen oder - NULLangefordert hat.linenumber
Zeilennummer in der Quelldatei, in der der Vorgang NULLoder Zuordnungen angefordert wurde.
Rückgabewert
Gibt einen Zeiger auf bufferzurück.Ein NULL Rückgabewert gibt einen Fehler an, und legen errno ist jede zu ENOMEMund gibt an, dass es den unzureichender Arbeitsspeicher vorhanden ist, um maxlen Bytes zuzuordnen (wenn ein NULLbufferals Argument angegeben wird), oder ERANGEan, wodurch angegeben wird, dass der Pfad länger als maxlen Zeichen ist.
Weitere Informationen finden Sie unter errno, _doserrno, _sys_errlist und _sys_nerr.
Hinweise
Die _getcwd_dbg und _wgetcwd_dbg-Funktionen sind in _getcwd und _wgetcwd identisch, mit der Ausnahme, dass bei _DEBUG definiert wird, verwenden diese Funktionen die Debugversion von malloc und _malloc_dbg , um Speicher belegen, wenn NULL als erster Parameter übergeben wird.Weitere Informationen finden Sie unter _malloc_dbg.
Sie müssen diese Funktionen in den meisten Fällen nicht explizit aufrufen.Stattdessen können Sie das Flag _CRTDBG_MAP_ALLOC definieren.Wenn _CRTDBG_MAP_ALLOC definiert wird, werden Aufrufe _getcwdund _wgetcwdzu _getcwd_dbgund_wgetcwd_dbgwenn blockType jeweils neu zugeordnet _NORMAL_BLOCKzu festgelegt ist.Daher ist es nicht erforderlich, um diese Funktionen explizit aufrufen, sofern der Heap als Bausteine _CLIENT_BLOCKkennzeichnen möchten.Weitere Informationen finden Sie unter Blocktypen auf dem Debugheap.
Zuweisung generischer Textroutinen
Tchar.h-Routine |
_UNICODE als auch _MBCS nicht definiert |
_MBCS definieren |
_UNICODE definiert |
|---|---|---|---|
_tgetcwd_dbg |
_getcwd_dbg |
_getcwd_dbg |
_wgetcwd_dbg |
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_getcwd_dbg |
<crtdbg.h> |
_wgetcwd_dbg |
<crtdbg.h> |
Weitere Informationen finden Sie unter Kompatibilität Kompatibilität in der Einführung.