_getdcwd_dbg, _wgetdcwd_dbg
Versioni di debug delle funzioni _getdcwd, _wgetdcwd (disponibili solo durante il debug).
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_dbge wchar_tper _wgetdcwd_dbg.blockType
Tipo di blocco di memoria richiesto: _CLIENT_BLOCKo _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 valore restituito di NULL indica un errore e errno viene impostato su ENOMEM, indicando che non vi è memoria sufficiente per allocare maxlen byte (quando un argomento NULL viene fornito come buffer) oppure su ERANGE, indicando che il percorso è più lungo di maxlen caratteri. Per altre informazioni, vedere errno, _doserrno, _sys_errlist, and _sys_nerr.
Note
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 altre informazioni, vedere _malloc_dbg.
Nella maggior parte dei casi non è necessario chiamare queste funzioni in modo esplicito. 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. Quindi, non è necessario chiamare queste funzioni in modo esplicito a meno che non si vogliano contrassegnare blocchi di memoria 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 definiti |
_MBCS definito |
_UNICODE definito |
|---|---|---|---|
_tgetdcwd_dbg |
_getdcwd_dbg |
_getdcwd_dbg |
_wgetdcwd_dbg |
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
_getdcwd_dbg |
<crtdbg.h> |
_wgetdcwd_dbg |
<crtdbg.h> |
Per altre informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.