_fullpath_dbg, _wfullpath_dbg

Versioni di _fullpath, _wfullpath che usano la versione di debug di malloc per allocare memoria.

Sintassi

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_dbg ma in caratteri wide (wchar_t) per _wfullpath_dbg.

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 si verifica un errore ( ad esempio, se il valore passato relPath include una lettera di unità non valida o non è possibile trovare o se la lunghezza del nome del percorso assoluto creato (absPath) è maggiore di maxLength) la funzione restituisce NULL.

Osservazioni:

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

Non è necessario chiamare queste funzioni in modo esplicito nella maggior parte dei casi. 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. Pertanto, non è necessario chiamare queste funzioni in modo esplicito, a meno che non si voglia contrassegnare i blocchi dell'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 definito	_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 Compatibility (Compatibilità).

Vedi anche

Gestione dei file
_fullpath, _wfullpath
Versioni di debug di funzioni di allocazione heap