_getcwd_dbg, _wgetcwd_dbg

Depurar versiones de las _getcwdfunciones , _wgetcwd (solo disponibles durante la depuración).

Sintaxis

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
Ubicación de almacenamiento de la ruta de acceso.

maxlen
Longitud máxima de la ruta de acceso en caracteres: char para _getcwd_dbg y wchar_t para _wgetcwd_dbg.

blockType
Tipo de bloque de memoria solicitado: _CLIENT_BLOCK o _NORMAL_BLOCK.

filename
Puntero al nombre del archivo de código fuente que solicitó la operación de asignación o valor NULL.

linenumber
Número de línea del archivo de código fuente en la que se solicitó la operación de asignación o valor NULL.

Valor devuelto

Devuelve un puntero a buffer. Un NULL valor devuelto indica un error y errno se establece en ENOMEM, lo que indica que no hay memoria suficiente para asignar maxlen bytes (cuando se proporciona un NULL argumento como buffer), o a ERANGE, lo que indica que la ruta de acceso es mayor maxlen que los caracteres.

Para obtener más información, veaerrno, _doserrno, _sys_errlisty _sys_nerr.

Comentarios

Las _getcwd_dbg funciones y _wgetcwd_dbg son idénticas a _getcwd y _wgetcwd , salvo que, cuando _DEBUG se define, estas funciones usan la versión de depuración de malloc y _malloc_dbg para asignar memoria si NULL se pasa como primer parámetro. Para obtener más información, vea _malloc_dbg.

No es necesario llamar explícitamente a estas funciones en la mayoría de los casos. En lugar de ello, se puede definir la marca _CRTDBG_MAP_ALLOC. Si se define _CRTDBG_MAP_ALLOC, las llamadas a _getcwd y _wgetcwd se reasignan a _getcwd_dbg y _wgetcwd_dbg, respectivamente, con el parámetro blockType establecido en _NORMAL_BLOCK. Por lo tanto, no es necesario llamar explícitamente a estas funciones a menos que desee marcar los bloques del montón como _CLIENT_BLOCK. Para obtener más información, consulte Tipos de bloques en el montón de depuración.

Asignación de rutina de texto genérico

Rutina Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tgetcwd_dbg	_getcwd_dbg	_getcwd_dbg	_wgetcwd_dbg

Requisitos

Routine	Encabezado necesario
_getcwd_dbg	<crtdbg.h>
_wgetcwd_dbg	<crtdbg.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Consulte también

_getcwd, _wgetcwd
Control de directorio
Versiones de depuración de las funciones de asignación del montón