_fullpath_dbg, _wfullpath_dbg

Versiones de , _wfullpath que usan la versión de _fullpathdepuración de malloc para asignar memoria.

Sintaxis

char *_fullpath_dbg(
   char *absPath,
   const char *relPath,
   size_t maxLength,
   int blockType,
   const char *filename,
   int linenumber
);
wchar_t *_wfullpath_dbg(
   wchar_t *absPath,
   const wchar_t *relPath,
   size_t maxLength,
   int blockType,
   const char *filename,
   int linenumber
);

Parámetros

absPath
Puntero al búfer que contiene el nombre de ruta de acceso absoluta o completa, o bien NULL.

relPath
Nombre de ruta de acceso relativa.

maxLength
Longitud máxima del búfer de nombre de ruta de acceso absoluta (absPath). Esta longitud se muestra en bytes para _fullpath_dbg y en caracteres anchos (wchar_t) para _wfullpath_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 bien 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

Cada función devuelve un puntero al búfer que contiene el nombre de ruta de acceso absoluta (absPath). Si se produce un error (por ejemplo, si el valor pasado incluye relPath una letra de unidad que no es válida o no se encuentra, o si la longitud del nombre de ruta de acceso absoluta creado (absPath) es mayor que maxLength) la función devuelve NULL.

Comentarios

Las _fullpath_dbg funciones y _wfullpath_dbg son idénticas a _fullpath y _wfullpath , salvo que, cuando _DEBUG se define, estas funciones usan la versión de depuración de malloc, _malloc_dbgpara asignar memoria si NULL se pasa como primer parámetro. Para obtener información sobre las características de depuración de _malloc_dbg, 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 _fullpath y _wfullpath se reasignan a _fullpath_dbg y _wfullpath_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
_tfullpath_dbg	_fullpath_dbg	_fullpath_dbg	_wfullpath_dbg

Requisitos

Función	Encabezado necesario
_fullpath_dbg	<crtdbg.h>
_wfullpath_dbg	<crtdbg.h>

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

Consulte también

Control de archivos
_fullpath, _wfullpath
Versiones de depuración de las funciones de asignación del montón