Fungsi GetSystemWindowsDirectoryA (sysinfoapi.h)

Mengambil jalur direktori Windows bersama pada sistem multi-pengguna.

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.

Sintaksis

UINT GetSystemWindowsDirectoryA(
  [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 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.

Mengembalikan nilai

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

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

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

Komentar

Pada sistem yang menjalankan Layanan Terminal, setiap pengguna memiliki direktori Windows yang unik. Direktori Windows sistem dibagikan oleh semua pengguna, jadi ini adalah direktori tempat aplikasi harus menyimpan inisialisasi dan membantu file yang berlaku untuk semua pengguna.

Dengan Layanan Terminal, fungsi GetSystemWindowsDirectory mengambil jalur direktori Windows sistem, sementara fungsi GetWindowsDirectory mengambil jalur direktori Windows yang privat untuk setiap pengguna. Pada sistem pengguna tunggal, GetSystemWindowsDirectory sama dengan GetWindowsDirectory.

Nota

Header sysinfoapi.h mendefinisikan GetSystemWindowsDirectory sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	sysinfoapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

GetWindowsDirectory

SHGetFolderLocation

Fungsi Informasi Sistem