_getdcwd_dbg, _wgetdcwd_dbg

Articolo
03/05/2013

Versioni di debug di _getdcwd, _wgetdcwd funzioni (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
percorso di archiviazione per il percorso.
maxlen
Lunghezza massima del percorso nei caratteri: char per _getdcwd_dbge wchar_tper _wgetdcwd_dbg.
blockType
Tipo richiesto del blocco di memoria: _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 l'operazione di allocazione è stata richiesta o NULL.

Valore restituito

restituisce un puntatore a buffer.In NULL il valore restituito indica un errore e errno è impostato su o su ENOMEM, per indicare che è disponibile memoria insufficiente da allocare maxlen byte (quando a NULL l'argomento è fornito come buffer), oppure ERANGE, per indicare che il percorso è più lungo di maxlen caratteri.Per ulteriori informazioni, vedere errno, _doserrno, _sys_errlist e _sys_nerr.

Note

_getdcwd_dbg e _wgetdcwd_dbg le funzioni sono identiche a _getdcwd e _wgetdcwd con la differenza che, quando _DEBUG viene definito, queste funzioni utilizzano la versione di debug di malloc e _malloc_dbg per allocare memoria se NULL l'oggetto viene passato come buffer parametro.Per ulteriori informazioni, vedere differenze.

Non è necessario chiamare queste funzioni in modo esplicito nella maggior parte dei casi.In alternativa, è possibile definire _CRTDBG_MAP_ALLOC flag.quando _CRTDBG_MAP_ALLOC viene definito, le chiamate a _getdcwd e _wgetdcwd riassociata a _getdcwd_dbg e _wgetdcwd_dbg, rispettivamente, con blockType impostare su _NORMAL_BLOCK.Pertanto, non è necessario chiamare queste funzioni in modo esplicito a meno che non si desideri contrassegnare i blocchi dell'heap come _CLIENT_BLOCK.Per ulteriori informazioni, vedere Tipi di blocchi sull'heap di debug.

Mapping di routine a testo generico

routine di Tchar.h	_UNICODE e _MBCS non definiti	_MBCS definito	_UNICODE definito
_tgetdcwd_dbg	_getdcwd_dbg	_getdcwd_dbg	_wgetdcwd_dbg

Requisiti

routine	Intestazione di associazione
_getdcwd_dbg	<crtdbg.h>
_wgetdcwd_dbg	<crtdbg.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Equivalente .NET Framework

Environment.CurrentDirectory

Vedere anche

Riferimenti

_getdcwd, _wgetdcwd

Controllo della directory

Concetti

Versioni di debug di funzioni di allocazione heap

Condividi tramite