_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

Create

Vea también

Referencia

El control de archivo

_fullpath, _wfullpath

Conceptos

Versiones de depuración de las funciones de asignación del montón