_getcwd_dbg, _wgetcwd_dbg

Versões de depuração 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.

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 _getcwd_dbg funções and _wgetcwd_dbg são idênticas e _wgetcwd _getcwd exceto que, quando _DEBUG é definida, essas funções usam a versão de depuração de malloc and _malloc_dbg 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. 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.

Mapeamento de rotina de texto genérico

Requisitos

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