_getcwd_dbg, _wgetcwd_dbg

Depurar versões das funções , _wgetcwd (disponíveis apenas durante a _getcwddepuração).

Sintaxe

char *_getcwd_dbg(
   char *buffer,
   int maxlen,
   int blockType,
   const char *filename,
   int linenumber
);
wchar_t *_wgetcwd_dbg(
   wchar_t *buffer,
   int maxlen,
   int blockType,
   const char *filename,
   int linenumber
);

Parâmetros

buffer
Local de armazenamento para o caminho.

maxlen
Comprimento máximo do caminho em caracteres: char para _getcwd_dbg e wchar_t para _wgetcwd_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.

Retornar valor

Retorna um ponteiro para buffer. Um NULL valor de retorno indica um erro e errno é definido como , indicando que há memória insuficiente para alocar maxlen bytes (quando um NULL argumento é dado como ), ou como ERANGEENOMEMbuffer, indicando que o caminho é maior que maxlen caracteres.

Para obter mais informações, consulte errno, _doserrno, _sys_errlist e _sys_nerr.

Comentários

As _getcwd_dbg funções e são idênticas a e exceto que, quando _DEBUG é definido, essas funções usam a _getcwd versão de depuração de malloc e _malloc_dbg_wgetcwd_dbg_wgetcwd para alocar memória se NULL for passada como o primeiro parâmetro. 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 _getcwd e _wgetcwd são remapeadas para _getcwd_dbg e _wgetcwd_dbg, respectivamente, com o blockType definido como _NORMAL_BLOCK. Assim, 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.

Mapeamento de rotina de texto genérico

Rotina Tchar.h	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_tgetcwd_dbg	_getcwd_dbg	_getcwd_dbg	_wgetcwd_dbg

Requisitos

Rotina	Cabeçalho necessário
_getcwd_dbg	<crtdbg.h>
_wgetcwd_dbg	<crtdbg.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

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