_getdcwd_dbg, _wgetdcwd_dbg

Eseguire il debug delle versioni di _getdcwd, _wgetdcwd funzioni (disponibili solo durante il debug).

Sintassi

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

Parametri

drive
Nome dell'unità disco.

buffer
Posizione di archiviazione per il percorso.

maxlen
Lunghezza massima del percorso in caratteri: char per _getdcwd_dbg e wchar_t per _wgetdcwd_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 funzioni _getdcwd_dbg e _wgetdcwd_dbg sono identiche a _getdcwd e _wgetdcwd ad eccezione che, quando _DEBUG è definito, queste funzioni usano la versione di debug di malloc e _malloc_dbg per allocare memoria se viene passato NULL come parametro buffer. 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 _getdcwd e _wgetdcwd vengono mappate nuovamente a _getdcwd_dbg e _wgetdcwd_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
_tgetdcwd_dbg	_getdcwd_dbg	_getdcwd_dbg	_wgetdcwd_dbg

Requisiti

Ciclo	Intestazione obbligatoria
_getdcwd_dbg	<crtdbg.h>
_wgetdcwd_dbg	<crtdbg.h>

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

Vedi anche

_getdcwd, _wgetdcwd
Controllo directory
Versioni di debug di funzioni di allocazione heap