_getdcwd_dbg, _wgetdcwd_dbg

Artigo
02/25/2013

Versões de depuração da _getdcwd, _wgetdcwd funções (disponíveis apenas durante a depuração).

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
O comprimento máximo do caminho em caracteres: char para _getdcwd_dbge wchar_tpara _wgetdcwd_dbg.
blockType
Solicitou um tipo de bloco de memória: _CLIENT_BLOCKou _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 _getdcwd_dbg e _wgetdcwd_dbg funções são idênticas às _getdcwd e _wgetdcwd , 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 buffer 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.Quando _CRTDBG_MAP_ALLOC for definido, chamadas para _getdcwd e _wgetdcwd são remapeados para _getdcwd_dbg e _wgetdcwd_dbg, respectivamente, com o blockType definido como _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