_getdcwd_dbg, _wgetdcwd_dbg

Versões de depuração das funções , _wgetdcwd (disponíveis apenas durante a _getdcwddepuração).

Sintaxe

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: char para _getdcwd_dbg e wchar_t para _wgetdcwd_dbg.

blockType
Tipo de bloco de memória solicitado: _CLIENT_BLOCK ou _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 retornado

Retorna um ponteiro para buffer. Um NULL valor retornado indica um erro e errno é definido como ENOMEM, indicando que não há memória suficiente para alocar maxlen bytes (quando um NULL argumento é fornecido como buffer), ou como ERANGE, indicando que o caminho é maior que maxlen os caracteres. 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.

Você não precisa chamar essas funções explicitamente na maioria dos casos. 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. Portanto, você não precisa chamar essas funções explicitamente, a menos que queira marcar os blocos de heap como _CLIENT_BLOCK. Para obter mais informações, consulte Tipos de blocos no heap de depuração.

Mapeamentos de 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 informações sobre compatibilidade, consulte Compatibilidade.

Confira também

_getdcwd, _wgetdcwd
Controle de diretório
Versões de depuração das funções de alocação de heap