_getdcwd_dbg, _wgetdcwd_dbg

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

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.

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.

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
RutinaEncabezado necesario
_getdcwd_dbg<crtdbg.h>
_wgetdcwd_dbg<crtdbg.h>

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

Environment.CurrentDirectory

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

Mostrar: