_getcwd_dbg, _wgetcwd_dbg

Artigo
08/25/2010

Versões de depurar do _getcwd, _wgetcwd funções (disponível apenas durante a depurar).

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_dbgand wchar_tfor _wgetcwd_dbg.
blockType
Solicitado o tipo de bloco de memória: _CLIENT_BLOCK ou _NORMAL_BLOCK.
filename
Ponteiro para o nome do arquivo de fonte que solicitou a operação de alocação ou NULL.
linenumber
Linha número no arquivo de fonte em que a operação de alocação foi solicitada ou NULL.

Valor de retorno

Retorna um ponteiro para buffer. A NULL valor retornado indica um erro, e errno é conjunto para ENOMEM, indicando que há memória suficiente para alocar maxlen bytes (quando um NULL argumento é passado sistema autônomo buffer), ou para ERANGE, indicando que o caminho é maior que maxlen caracteres.

For more information, see errno, _doserrno, _sys_errlist e _sys_nerr.

Comentários

The _getcwd_dbg e _wgetcwd_dbg funções são idênticas _getcwd e _wgetcwd exceto pelo fato de que, quando _DEBUG é definido, essas funções usam a versão de depurar do malloc e _malloc_dbg alocar a memória se NULL é passado sistema autônomo o primeiro parâmetro. For more information, see _malloc_dbg.

Você não precisa telefonar essas funções explicitamente na maioria dos casos.Em vez disso, você pode definir o _CRTDBG_MAP_ALLOC sinalizar. When _CRTDBG_MAP_ALLOC is defined, calls to _getcwdand _wgetcwdare remapped to _getcwd_dbgand _wgetcwd_dbg, respectively, with the blockType set to _NORMAL_BLOCK.Portanto, não é necessário chamar essas funções explicitamente, a menos que você deseja marcar sistema autônomo blocos de heap sistema autônomo _CLIENT_BLOCK. For more information, see Tipos de blocos na heap de Depurar.

Mapeamentos de rotina de texto genérica

Rotina tchar.h	_UNICODE e _MBCS não definido	_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 de compatibilidade, consulte Compatibility na introdução.

Equivalente do NET Framework

CurrentDirectory

Consulte também

Conceitos

Depurar de versões de funções de alocação de heap

Referência

_getcwd, _wgetcwd

Controle de diretório

Partilhar via