_getcwd_dbg
, _wgetcwd_dbg
Depurar versões das funções , _wgetcwd
(disponíveis apenas durante a _getcwd
depuraçã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 ERANGE
ENOMEM
buffer
, 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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de