Fungsi GetTempPath2W (fileapi.h)
Mengambil jalur direktori yang ditunjuk untuk file sementara, berdasarkan hak istimewa proses panggilan.
Sintaks
DWORD GetTempPath2W(
[in] DWORD BufferLength,
[out] LPWSTR Buffer
);
Parameter
[in] BufferLength
Ukuran buffer string yang diidentifikasi oleh lpBuffer, dalam TCHAR.
[out] Buffer
Penunjuk ke buffer string yang menerima string yang dihentikan null yang menentukan jalur file sementara. String yang dikembalikan diakhir dengan garis miring terbelakang, misalnya, "C:\TEMP\".
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah panjangnya, dalam TCHAR, dari string yang disalin ke lpBuffer, tidak termasuk karakter null yang mengakhiri. Jika nilai yang dikembalikan lebih besar dari nBufferLength, nilai yang dikembalikan adalah panjangnya, di TCHAR, dari buffer yang diperlukan untuk menahan jalur.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Nilai pengembalian maksimum yang mungkin adalah MAX_PATH+1 (261).
Keterangan
Saat memanggil fungsi ini dari proses yang berjalan sebagai SYSTEM, fungsi ini akan mengembalikan jalur C:\Windows\SystemTemp, yang tidak dapat diakses oleh proses non-SISTEM. Untuk proses non-SISTEM, GetTempPath2 akan berulah sama dengan GetTempPath.
Fungsi GetTempPath2 memeriksa keberadaan variabel lingkungan dalam urutan berikut dan menggunakan jalur pertama yang ditemukan:
- Jalur yang ditentukan oleh variabel lingkungan TMP.
- Jalur yang ditentukan oleh variabel lingkungan TEMP.
- Jalur yang ditentukan oleh variabel lingkungan USERPROFILE.
- Direktori Windows.
Perilaku tautan simbolis—Jika jalur menunjuk ke tautan simbolis, nama jalur sementara mempertahankan tautan simbolis apa pun.
Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.
Teknologi | Didukung |
---|---|
Protokol Server Message Block (SMB) 3.0 | Ya |
SMB 3.0 Transparent Failover (TFO) | Ya |
SMB 3.0 dengan Berbagi File Peluasan Skala (SO) | Ya |
Sistem File Volume Bersama Kluster (CsvFS) | Ya |
Sistem File Tangguh (ReFS) | Ya |
Contoh
Misalnya, lihat Membuat dan Menggunakan File Sementara.
Catatan
Header fileapi.h mendefinisikan GetTempPath2 sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 10 Build 20348 |
Server minimum yang didukung | Windows Server Build 20348 |
Header | fileapi.h (sertakan Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk