Fungsi GetSystemDirectoryA (sysinfoapi.h)

Mengambil jalur direktori sistem. Direktori sistem berisi file sistem seperti pustaka tautan-dinamis dan driver.

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

Sintaks

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

Parameter

[out] lpBuffer

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

[in] uSize

Ukuran maksimum buffer, dalam TCHAR.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah panjangnya, dalam TCHAR, dari string yang disalin ke buffer, tidak termasuk karakter null yang mengakhiri. Jika panjangnya lebih besar dari ukuran buffer, nilai yang dikembalikan adalah ukuran buffer yang diperlukan untuk menahan jalur, termasuk karakter null yang mengakhiri.

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

Keterangan

Aplikasi tidak boleh membuat file di direktori sistem. Jika pengguna menjalankan versi bersama dari sistem operasi, aplikasi tidak memiliki akses tulis ke direktori sistem.

Contoh

Misalnya, lihat Mendapatkan Informasi Sistem.

Catatan

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

Lihat juga

GetCurrentDirectory

GetWindowsDirectory

SetCurrentDirectory

Fungsi Informasi Sistem