_getcwd_dbg, _wgetcwd_dbg
Versões de depuração das funções _getcwd, _wgetcwd (disponíveis somente durante a depuração).
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 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 _getcwd_dbg e _wgetcwd_dbg são idênticas a _getcwd e _wgetcwd. A única diferença é 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 primeiro parâmetro. 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 _getcwde _wgetcwd são remapeadas para _getcwd_dbge _wgetcwd_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 |
|---|---|---|---|
_tgetcwd_dbg |
_getcwd_dbg |
_getcwd_dbg |
_wgetcwd_dbg |
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
_getcwd_dbg |
<crtdbg.h> |
_wgetcwd_dbg |
<crtdbg.h> |
Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.