Condividi tramite


_fullpath_dbg, _wfullpath_dbg

Versioni di _fullpath, _wfullpathche usa la versione di debug di malloc per allocare 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  );

Parametri

  • absPath
    Puntatore a un buffer contenente il nome del percorso assoluto o completo o NULL.

  • relPath
    Nome del percorso relativo.

  • maxLength
    Lunghezza massima del buffer del nome del percorso assoluto (absPath). Tale lunghezza è espressa in byte per _fullpath ma in caratteri wide (wchar_t) per _wfullpath.

  • blockType
    Tipo richiesto di blocco di memoria: _CLIENT_BLOCK o _NORMAL_BLOCK.

  • filename
    Puntatore al nome del file di origine che ha richiesto l'operazione di allocazione o NULL.

  • linenumber
    Numero di riga nel file di origine in cui è stata richiesta l'operazione di allocazione o NULL.

Valore restituito

Ogni funzione restituisce un puntatore a un buffer contenente il nome del percorso assoluto (absPath). Se è presente un errore (ad esempio, se il valore passato in relPath include una lettera di unità non valida o che non può essere trovata oppure se la lunghezza del nome del percorso assoluto creato (absPath) è maggiore di maxLength) la funzione restituisce NULL.

Note

Le funzioni _fullpath_dbg e _wfullpath_dbg sono identiche a _fullpath e _wfullpath ad eccezione che, quando **_**DEBUG è definito, queste funzioni usano la versione di debug di malloc, _malloc_dbg per allocare memoria se viene passato NULL come primo parametro. Per informazioni sulle funzionalità di debug di _malloc_dbg, vedere _malloc_dbg.

Nella maggior parte dei casi non è necessario chiamare queste funzioni in modo esplicito. In alternativa, è possibile definire il flag _CRTDBG_MAP_ALLOC. Quando _CRTDBG_MAP_ALLOC è definito, le chiamate a _fullpath e _wfullpath vengono mappate nuovamente a _fullpath_dbg e _wfullpath_dbg rispettivamente, con blockType impostato su _NORMAL_BLOCK. Quindi, non è necessario chiamare queste funzioni in modo esplicito a meno che non si vogliano contrassegnare blocchi di memoria heap come _CLIENT_BLOCK. Per altre informazioni, vedere Tipi di blocchi sull'heap di debug.

Mapping di routine di testo generico

Routine Tchar.h

_UNICODE e _MBCS non definiti

_MBCS definito

_UNICODE definito

_tfullpath_dbg

_fullpath_dbg

_fullpath_dbg

_wfullpath_dbg

Requisiti

Funzione

Intestazione obbligatoria

_fullpath_dbg

<crtdbg.h>

_wfullpath_dbg

<crtdbg.h>

Per altre informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Equivalente .NET Framework

Create

Vedere anche

Riferimenti

Gestione di file

_fullpath, _wfullpath

Concetti

Versioni di debug di funzioni di allocazione heap