_fullpath_dbg, _wfullpath_dbg

 

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

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

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 y en caracteres anchos (wchar_t) para _wfullpath.

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.

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, el valor que se pasa en relPath incluye una letra de unidad que no es válida o no se puede encontrar, o si la longitud del nombre de ruta de acceso absoluta creado (absPath) es mayor que maxLength, la función devuelve NULL.

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

Asignaciones de rutina de texto genérico

Rutina Tchar.h_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_tfullpath_dbg_fullpath_dbg_fullpath_dbg_wfullpath_dbg
FunciónEncabezado necesario
_fullpath_dbg<crtdbg.h>
_wfullpath_dbg<crtdbg.h>

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

Crear

Control de archivos
_fullpath, _wfullpath
Las versiones de funciones de asignación del montón de depuración

Mostrar: