Compartir a través de


_getdcwd_dbg, _wgetdcwd_dbg

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

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_dbgy wchar_tpara _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 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 _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.

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 _getdcwd y _wgetdcwd se reasignan a _getdcwd_dbg y _wgetdcwd_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

_tgetdcwd_dbg

_getdcwd_dbg

_getdcwd_dbg

_wgetdcwd_dbg

Requisitos

Rutina

Encabezado necesario

_getdcwd_dbg

<crtdbg.h>

_wgetdcwd_dbg

<crtdbg.h>

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

Equivalente en .NET Framework

Environment.CurrentDirectory

Vea también

Referencia

_getdcwd, _wgetdcwd

Control de directorio

Conceptos

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