_getdcwd_dbg, _wgetdcwd_dbg
Versões de depuração das funções _getdcwd, _wgetdcwd (disponíveis somente durante a depuração).
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 );
Parâmetros
drive
Nome da unidade de disco.buffer
Local de armazenamento para o caminho.maxlen
Comprimento máximo do caminho em caracteres: charpara _getdcwd_dbge wchar_tpara _wgetdcwd_dbg.blockType
Tipo solicitado do bloco de memória: _CLIENT_BLOCKou _NORMAL_BLOCK.filename
Ponteiro para o nome do arquivo de origem que solicitou a operação de alocação ou NULL.linenumber
Número da linha no arquivo de origem em que a operação de alocação foi solicitada ou NULL.
Valor de retorno
Retorna um ponteiro para buffer. Um valor retornado NULL indica que houve um erro e errno é definido como ENOMEM, indicando que a memória não é suficiente para alocar os bytes de maxlen (quando um argumento NULL é informado como buffer), ou como ERANGE, indicando que o caminho tem mais caracteres que o definido pelo parâmetro maxlen. Para obter mais informações, consulte errno, _doserrno, _sys_errlist e _sys_nerr.
Comentários
As funções _getdcwd_dbg e _wgetdcwd_dbg são idênticas a _getdcwd e _wgetdcwd, exceto pelo fato de que, quando _DEBUG é definido, essas funções usam a versão de depuração de malloc e _malloc_dbg para alocar memória se NULL for apresentado como parâmetro buffer. Para obter mais informações, consulte _malloc_dbg.
Na maioria dos casos, não é necessário chamar essas funções explicitamente. Em vez disso, você pode definir o sinalizador _CRTDBG_MAP_ALLOC. Quando _CRTDBG_MAP_ALLOC é definido, as chamadas a _getdcwd e _wgetdcwd são remapeadas para _getdcwd_dbg e _wgetdcwd_dbg, respectivamente, com o blockType definido como _NORMAL_BLOCK. Assim, não é necessário chamar essas funções explicitamente, a menos que você queira marcar os blocos de heap como _CLIENT_BLOCK. Para obter mais informações, consulte Tipos de blocos na heap de depuração.
Mapeamentos da rotina de texto genérico
Rotina Tchar.h |
_UNICODE e _MBCS não definidos |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_tgetdcwd_dbg |
_getdcwd_dbg |
_getdcwd_dbg |
_wgetdcwd_dbg |
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
_getdcwd_dbg |
<crtdbg.h> |
_wgetdcwd_dbg |
<crtdbg.h> |
Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.