_fullpath_dbg, _wfullpath_dbg
Versiones de _fullpath, _wfullpath que utilizan la versión de depuración de 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 a un búfer que contiene el valor absoluto o la ruta de acceso completa, o NULL.relPath
Nombre de la ruta de acceso relativa.maxLength
Longitud máxima del búfer del nombre de ruta de acceso absoluta (absPath).Esta longitud está en bytes para _fullpath pero en caracteres anchos (wchar_t) para _wfullpath.blockType
tipo solicitado de bloque de memoria: _CLIENT_BLOCK o _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
cada función devuelve un puntero a un búfer que contiene el nombre de ruta de acceso absoluta (absPath).Si hay un error (por ejemplo, si el último valor de relPath incluye una letra de unidad no válida o no puede encontrar, o si la longitud del nombre de ruta de acceso absoluta creado (absPath) que es mayor que maxLength) la función devuelve NULL.
Comentarios
Las funciones de _fullpath_dbg y de _wfullpath_dbg son idénticas a _fullpath y a _wfullpath salvo que, cuando **_**DEBUGestá definido, estas funciones utilizan la versión de depuración de malloc, _malloc_dbg, para 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 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_ALLOCestá definido, las llamadas a _fullpath y _wfullpathse reasignan a _fullpath_dbg y a _wfullpath_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
rutina de Tchar.h |
_UNICODE y _MBCS no definido |
_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 de compatibilidad, vea Compatibilidad en la Introducción.
Equivalente en .NET Framework
Vea también
Referencia
Conceptos
Versiones de depuración de las funciones de asignación del montón