_getdcwd_dbg, _wgetdcwd_dbg

Depurar versiones de las _getdcwdfunciones , _wgetdcwd (solo disponibles durante la depuración).

Sintaxis

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
Nombre de la unidad de disco.

buffer
Ubicación de almacenamiento de la ruta de acceso.

maxlen
Longitud máxima de la ruta de acceso en caracteres: char para _getdcwd_dbg y wchar_t para _wgetdcwd_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 funciones _getdcwd_dbg y _wgetdcwd_dbg son idénticas a _getdcwd y _wgetdcwd, 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 parámetro de buffer. 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 _getdcwd y _wgetdcwd se reasignan a _getdcwd_dbg y _wgetdcwd_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.

Asignaciones de rutinas de texto genérico

Rutina Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tgetdcwd_dbg	_getdcwd_dbg	_getdcwd_dbg	_wgetdcwd_dbg

Requisitos

Routine	Encabezado necesario
_getdcwd_dbg	<crtdbg.h>
_wgetdcwd_dbg	<crtdbg.h>

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

Consulte también

_getdcwd, _wgetdcwd
Control de directorio
Versiones de depuración de las funciones de asignación del montón