_fullpath_dbg, _wfullpath_dbg
versioni di _fullpath, _wfullpath che utilizzano 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 che contiene assoluto o il nome di percorso completo, o NULL.relPath
Percorso relativo.maxLength
Lunghezza massima del buffer del nome del percorso assoluto (absPath).Tale lunghezza in byte per _fullpath ma i caratteri di tipo " wide " (wchar_tper) _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 l'operazione di allocazione è stata richiesta o NULL.
Valore restituito
Ogni funzione restituisce un puntatore a un buffer che contiene il nome del percorso assoluto (absPath).Se c " è un errore (ad esempio, se il valore passata in relPath include una lettera di unità non valida o non viene trovata, oppure se la lunghezza del nome del percorso assoluto creato (absPath) è maggiore di maxLengthla funzione restituisce NULL.
Note
_fullpath_dbg e _wfullpath_dbg le funzioni sono identiche a _fullpath e _wfullpath con la differenza che, quando **_**DEBUGviene definito, queste funzioni utilizzano la versione di debug di malloc, _malloc_dbg, per allocare memoria se NULL viene passato come primo parametro.Per informazioni sulle funzionalità di debug _malloc_dbg, vedere differenze.
Non è necessario chiamare queste funzioni in modo esplicito nella maggior parte dei casi.In alternativa, è possibile definire _CRTDBG_MAP_ALLOC flag.quando _CRTDBG_MAP_ALLOCviene definito, le chiamate a _fullpath e _wfullpathriassociata a _fullpath_dbg e _wfullpath_dbg, rispettivamente, con blockType impostare su _NORMAL_BLOCK.Pertanto, non è necessario chiamare queste funzioni in modo esplicito a meno che non si desideri contrassegnare i blocchi dell'heap come _CLIENT_BLOCK.Per ulteriori informazioni, vedere Tipi di blocchi sull'heap di debug.
Mapping di routine a testo generico
routine di Tchar.h |
_UNICODE e _MBCS non definiti |
_MBCS definito |
_UNICODE definito |
---|---|---|---|
_tfullpath_dbg |
_fullpath_dbg |
_fullpath_dbg |
_wfullpath_dbg |
Requisiti
Funzione |
Intestazione di associazione |
---|---|
_fullpath_dbg |
<crtdbg.h> |
_wfullpath_dbg |
<crtdbg.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.