_getcwd_dbg, _wgetcwd_dbg

 

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

Versiones de depuración de la _getcwd, _wgetcwd funciones (sólo está disponibles durante la 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.

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, consulte errno, _doserrno, _sys_errlist y _sys_nerr.

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, consulte _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. Cuando _CRTDBG_MAP_ALLOC está definido, las llamadas a _getcwdy _wgetcwdse reasignan a _getcwd_dbgy _wgetcwd_dbg, respectivamente, con el 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, consulte tipos de bloques en el montón de depuración.

Rutina Tchar.h_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_tgetcwd_dbg_getcwd_dbg_getcwd_dbg_wgetcwd_dbg
RutinaEncabezado necesario
_getcwd_dbg<crtdbg.h>
_wgetcwd_dbg<crtdbg.h>

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

CurrentDirectory

_getcwd, _wgetcwd
Control de directorio
Las versiones de funciones de asignación del montón de depuración

Mostrar: