_getcwd_dbg, _wgetcwd_dbg
Versões de depuração da _getcwd, _wgetcwd funções (disponíveis apenas 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
O comprimento máximo do caminho em caracteres: char para _getcwd_dbg e wchar_t para _wgetcwd_dbg.blockType
Solicitou um tipo de bloco de memória: _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
O número no arquivo de origem onde a operação de alocação foi solicitada de linha ou NULL.
Valor de retorno
Retorna um ponteiro para buffer.A NULL retornar valor indica um erro, e errno ou é definida como ENOMEM, indicando que há memória suficiente para alocar maxlen bytes (quando um NULL argumento é dado como buffer), ou para ERANGE, indicando que o caminho é maior do que maxlen caracteres.
Para obter mais informações, consulte errno, _doserrno, _sys_errlist e _sys_nerr.
Comentários
O _getcwd_dbg e _wgetcwd_dbg funções são idênticas às _getcwd e _wgetcwd , exceto que, quando _DEBUG é definida, essas funções usam a versão de depuração malloc e _malloc_dbg ao alocar memória se NULL é passado como o primeiro parâmetro.Para obter mais informações, consulte _malloc_dbg.
Você não precisará chamar essas funções explicitamente na maioria dos casos.Em vez disso, você pode definir a _CRTDBG_MAP_ALLOC sinalizador.When _CRTDBG_MAP_ALLOC is defined, calls to _getcwdand _wgetcwdare remapped to _getcwd_dbgand _wgetcwd_dbg, respectively, with the blockType set to _NORMAL_BLOCK.Assim, você não precisará chamar explicitamente essas funções, a menos que você deseja marcar os blocos de heap como _CLIENT_BLOCK.Para obter mais informações, consulte Tipos de blocos na pilha de depuração.
Mapeamentos de rotina de texto genérico
Rotina de TCHAR.h |
_ Unicode e _ MBCS do arquivo não definido |
_ MBCS do arquivo 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 de compatibilidade, consulte Compatibilidade na introdução.