_getcwd_dbg, _wgetcwd_dbg

Depura versiones de las funciones _getcwd, _wgetcwd (disponible únicamente durante una depuración).

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 valor devuelto de NULL indica un error, y errno se establece en ENOMEM, que indica que no hay memoria suficiente para asignar los bytes de maxlen (cuando un argumento de NULL se proporciona como buffer), o en ERANGE, que indica que la ruta de acceso es más larga que los caracteres de maxlen.

Para obtener más información, vea errno, _doserrno, _sys_errlist y _sys_nerr.

Comentarios

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

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

Asignaciones 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

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

Para obtener más información sobre compatibilidad, vea Compatibilidad en la introducción.

Equivalente en .NET Framework

CurrentDirectory

Vea también

Referencia

_getcwd, _wgetcwd

Control de directorio

Conceptos

Versiones de depuración de las funciones de asignación del montón