_getcwd_dbg, _wgetcwd_dbg

Eseguire il debug delle versioni di _getcwd, _wgetcwd funzioni (disponibili solo durante il debug).

Sintassi

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
);

Parametri

buffer
Posizione di archiviazione per il percorso.

maxlen
Lunghezza massima del percorso in caratteri: char per _getcwd_dbg e wchar_t per _wgetcwd_dbg.

blockType
Tipo di blocco di memoria richiesto: _CLIENT_BLOCK o _NORMAL_BLOCK.

filename
Puntatore al nome del file di origine che ha richiesto l'operazione di allocazione o NULL.

linenumber
Numero di riga nel file di origine in cui è stata richiesta l'operazione di allocazione o NULL.

Valore restituito

Restituisce un puntatore a buffer. Un NULL valore restituito indica un errore e errno viene impostato su ENOMEM, a indicare che memoria insufficiente per allocare maxlen byte (quando un NULL argomento viene specificato come buffer) o su ERANGE, a indicare che il percorso è più lungo dei maxlen caratteri.

Per altre informazioni, vedereerrno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

Le _getcwd_dbg funzioni e _wgetcwd_dbg sono identiche a _getcwd e _wgetcwd ad eccezione del fatto che, quando _DEBUG viene definito, queste funzioni usano la versione di debug di malloc e _malloc_dbg per allocare memoria se NULL vengono passate come primo parametro. Per ulteriori informazioni, vedere _malloc_dbg.

Non è necessario chiamare queste funzioni in modo esplicito nella maggior parte dei casi. In alternativa, è possibile definire il flag _CRTDBG_MAP_ALLOC. Quando _CRTDBG_MAP_ALLOC è definito, le chiamate a _getcwd e _wgetcwd vengono mappate nuovamente a _getcwd_dbg e _wgetcwd_dbg rispettivamente, con blockType impostato su _NORMAL_BLOCK. Pertanto, non è necessario chiamare queste funzioni in modo esplicito, a meno che non si voglia contrassegnare i blocchi dell'heap come _CLIENT_BLOCK. Per altre informazioni, vedere Tipi di blocchi sull'heap di debug.

Mapping di routine di testo generico

Routine Tchar.h	_UNICODE e _MBCS non definito	_MBCS definito	_UNICODE definito
_tgetcwd_dbg	_getcwd_dbg	_getcwd_dbg	_wgetcwd_dbg

Requisiti

Ciclo	Intestazione obbligatoria
_getcwd_dbg	<crtdbg.h>
_wgetcwd_dbg	<crtdbg.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Vedi anche

_getcwd, _wgetcwd
Controllo directory
Versioni di debug di funzioni di allocazione heap