Fungsi GetWindowsDirectoryA (sysinfoapi.h)

Mengambil jalur direktori Windows.

Fungsi ini disediakan terutama untuk kompatibilitas dengan aplikasi lama. Aplikasi baru harus menyimpan kode di folder File Program dan data persisten di folder Data Aplikasi di profil pengguna. Untuk informasi selengkapnya, lihat ShGetFolderPath.

Sintaks

UINT GetWindowsDirectoryA(
  [out] LPSTR lpBuffer,
  [in]  UINT  uSize
);

Parameter

[out] lpBuffer

Penunjuk ke buffer yang menerima jalur. Jalur ini tidak berakhir dengan garis miring terbelakang kecuali direktori Windows adalah direktori akar. Misalnya, jika direktori Windows diberi nama Windows pada drive C, jalur direktori Windows yang diambil oleh fungsi ini adalah C:\Windows. Jika sistem diinstal di direktori akar drive C, jalur yang diambil adalah C:.

[in] uSize

Ukuran maksimum buffer yang ditentukan oleh parameter lpBuffer , dalam TCHAR. Nilai ini harus diatur ke MAX_PATH.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah panjang string yang disalin ke buffer, di TCHAR, tidak termasuk karakter null yang mengakhiri.

Jika panjangnya lebih besar dari ukuran buffer, nilai yang dikembalikan adalah ukuran buffer yang diperlukan untuk menahan jalur.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Direktori Windows adalah direktori tempat beberapa aplikasi warisan menyimpan inisialisasi dan file bantuan. Aplikasi baru tidak boleh menyimpan file di direktori Windows; sebaliknya, mereka harus menyimpan data di seluruh sistem di direktori penginstalan aplikasi, dan data khusus pengguna di profil pengguna.

Jika pengguna menjalankan versi bersama sistem, direktori Windows dijamin bersifat privat untuk setiap pengguna.

Jika aplikasi membuat file lain yang ingin disimpan per pengguna, aplikasi harus menempatkannya di direktori yang ditentukan oleh variabel lingkungan HOMEPATH. Direktori ini akan berbeda untuk setiap pengguna, jika ditentukan oleh administrator, melalui alat administratif Manajer Pengguna. HOMEPATH selalu menentukan direktori beranda pengguna, yang dijamin privat untuk setiap pengguna, atau direktori default (misalnya, C:\USERS\DEFAULT) di mana pengguna akan memiliki semua akses.

Layanan Terminal: Jika aplikasi berjalan di lingkungan Layanan Terminal, setiap pengguna memiliki direktori Windows privat. Ada juga direktori Windows bersama untuk sistem. Jika aplikasi sadar Terminal-Services (memiliki bendera IMAGE_DLLCHARACTERISTICS_TERMINAL_SERVER_AWARE yang diatur di header gambar), fungsi ini mengembalikan jalur direktori Windows sistem, sama seperti fungsi GetSystemWindowsDirectory . Jika tidak, ia mengambil jalur direktori Windows privat untuk pengguna.

Contoh

Misalnya, lihat Mendapatkan Informasi Sistem.

Catatan

Header sysinfoapi.h mendefinisikan GetWindowsDirectory 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 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	sysinfoapi.h (sertakan Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

GetCurrentDirectory

GetSystemDirectory

GetSystemWindowsDirectory

Fungsi Informasi Sistem