_getdcwd_dbg, _wgetdcwd_dbg

Artigo
08/25/2010

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

char *_getdcwd_dbg(
   int drive,
   char *buffer,
   int maxlen,
   int blockType,
   const char *filename,
   int linenumber 
);
wchar_t *_wgetdcwd_dbg(
   int drive,
   wchar_t *buffer,
   int maxlen,
   int blockType,
   const char *filename,
   int linenumber 
);

Parâmetros

drive
Nome da unidade de disco.
buffer
Local de armazenamento para o caminho.
maxlen
Comprimento máximo do caminho em caracteres: char for _getdcwd_dbgand wchar_tfor _wgetdcwd_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 _getdcwd_dbg e _wgetdcwd_dbg funções são idênticas _getdcwd e _wgetdcwd 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 buffer 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. Quando _CRTDBG_MAP_ALLOC é definido, chamadas para _getdcwdand _wgetdcwdare remapped to _getdcwd_dbgand _wgetdcwd_dbg, respectivamente, com o blockType conjunto para _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
_tgetdcwd_dbg	_getdcwd_dbg	_getdcwd_dbg	_wgetdcwd_dbg

Requisitos

Rotina	Cabeçalho necessário
_getdcwd_dbg	<crtdbg.h>
_wgetdcwd_dbg	<crtdbg.h>

Para obter mais informações de compatibilidade, consulte Compatibility na introdução.

Equivalente do NET Framework

Environment.CurrentDirectory

Consulte também

Conceitos

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

Referência

_getdcwd, _wgetdcwd

Controle de diretório

Partilhar via