_getdcwd_dbg, _wgetdcwd_dbg

Versiones de depuración de las funciones de _getdcwd, _wgetdcwd (sólo disponible durante la 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.
maxlen
Longitud máxima de ruta en caracteres: char para _getdcwd_dbgy wchar_tpara _wgetdcwd_dbg.
blockType
Tipo solicitado del bloque de memoria: _CLIENT_BLOCKo _NORMAL_BLOCK.
filename
Puntero al nombre del archivo de código fuente que solicitó la operación o NULLde asignación.
linenumber
Número de línea en el archivo de código fuente donde la operación de asignación se solicitó o NULL.

Valor devuelto

devuelve un puntero a buffer.Un valor devuelto de NULL indica un error, y errno es cualquier establecidos en ENOMEM, que indica que hay memoria suficiente para asignar los bytes de maxlen (cuando un argumento de NULL se proporciona como buffer), o a 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 de _getdcwd_dbg y de _wgetdcwd_dbg son idénticas a _getdcwd y a _wgetdcwd salvo que, cuando _DEBUG está definido, estas funciones utilizan la versión de depuración de malloc y de _malloc_dbg para asignar memoria si NULL se pasa como parámetro de buffer .Para obtener más información, vea _malloc_dbg.

No necesita llamar a estas funciones explícitamente en la mayoría de los casos.En su lugar, puede definir el marcador de _CRTDBG_MAP_ALLOC .Cuando _CRTDBG_MAP_ALLOC está definido, las llamadas a _getdcwd y _wgetdcwd se reasignan a _getdcwd_dbg y a _wgetdcwd_dbg, respectivamente, con blockType establecido en _NORMAL_BLOCK.Por consiguiente, no necesita llamar a estas funciones explícitamente a menos que desee marcar los bloques de pila como _CLIENT_BLOCK.Para obtener más información, vea Tipos de bloques en el montón de depuración.

Asignaciones de la rutina de texto genérico