_fullpath_dbg, _wfullpath_dbg

_fullpathVersi ,_wfullpathyang menggunakan versi malloc debug untuk mengalokasikan memori.

Sintaks

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
);

Parameter

absPath
Penunjuk ke buffer yang berisi nama jalur absolut atau lengkap, atau NULL.

relPath
Nama jalur relatif.

maxLength
Panjang maksimum buffer nama jalur absolut (absPath). Panjang ini dalam byte untuk _fullpath_dbg tetapi dalam karakter lebar (wchar_t) untuk _wfullpath_dbg.

blockType
Jenis blok memori yang diminta: _CLIENT_BLOCK atau _NORMAL_BLOCK.

filename
Penunjuk ke nama file sumber yang meminta operasi alokasi atau NULL.

linenumber
Nomor baris dalam file sumber tempat operasi alokasi diminta atau NULL.

Nilai hasil

Setiap fungsi mengembalikan penunjuk ke buffer yang berisi nama jalur absolut (absPath). Jika ada kesalahan (misalnya, jika nilai yang diteruskan relPath menyertakan huruf drive yang tidak valid atau tidak dapat ditemukan, atau jika panjang nama jalur absolut yang dibuat (absPath) lebih besar dari maxLength) fungsi mengembalikan NULL.

Keterangan

Fungsi _fullpath_dbg dan _wfullpath_dbg identik dengan _fullpath dan _wfullpath kecuali bahwa, ketika _DEBUG didefinisikan, fungsi-fungsi ini menggunakan versi debug dari malloc, _malloc_dbg, untuk mengalokasikan memori jika NULL diteruskan sebagai parameter pertama. Untuk informasi tentang fitur _malloc_dbgpenelusuran kesalahan , lihat _malloc_dbg.

Anda tidak perlu memanggil fungsi-fungsi ini secara eksplisit dalam banyak kasus. Sebagai gantinya _CRTDBG_MAP_ALLOC , Anda dapat menentukan bendera. Ketika _CRTDBG_MAP_ALLOC didefinisikan, panggilan ke _fullpath dan _wfullpath dipetakan ulang ke _fullpath_dbg dan _wfullpath_dbg, masing-masing, dengan blockType diatur ke _NORMAL_BLOCK. Dengan demikian, Anda tidak perlu memanggil fungsi-fungsi ini secara eksplisit kecuali Anda ingin menandai blok tumpukan sebagai _CLIENT_BLOCK. Untuk informasi selengkapnya, lihat Jenis blok pada tumpukan debug.

Pemetaan rutin teks generik

Rutinitas Tchar.h	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_tfullpath_dbg	_fullpath_dbg	_fullpath_dbg	_wfullpath_dbg

Persyaratan

Function	Header yang diperlukan
_fullpath_dbg	<crtdbg.h>
_wfullpath_dbg	<crtdbg.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Baca juga

Penanganan file
_fullpath, _wfullpath
Versi debug fungsi alokasi timbunan