Compartir a través de

_fullpath_dbg, _wfullpath_dbg

  • Artículo

Versiones de _fullpath, _wfullpath que usan 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 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.

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, 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.

Comentarios

Las funciones _fullpath_dbg y _wfullpath_dbg son idénticas a _fullpath y _wfullpath, salvo que, si **_**DEBUG se define, estas funciones usan la versión de depuración de 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, vea _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. Si se define _CRTDBG_MAP_ALLOC, las llamadas a _fullpath y _wfullpathse reasignan a _fullpath_dbg y _wfullpath_dbg respectivamente, con el parámetro 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, vea 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

Requisitos

Función

Encabezado necesario

_fullpath_dbg

<crtdbg.h>

_wfullpath_dbg

<crtdbg.h>

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

Equivalente en .NET Framework

Create

Vea también

Referencia

Control de archivos

_fullpath, _wfullpath

Conceptos

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