Fungsi SHRegGetPathA (shlwapi.h)

Artikel
03/02/2024

Mengambil jalur file dari registri, memperluas variabel lingkungan sesuai kebutuhan.

Sintaks

LSTATUS SHRegGetPathA(
  [in]  HKEY   hKey,
  [in]  LPCSTR pcszSubKey,
  [in]  LPCSTR pcszValue,
  [out] LPSTR  pszPath,
        DWORD  dwFlags
);

Parameter

[in] hKey

Jenis: HKEY

Handel ke kunci yang saat ini terbuka, atau kunci akar registri.

[in] pcszSubKey

Jenis: LPCTSTR

Penunjuk ke string yang dihentikan null yang berisi nama subkunci.

[in] pcszValue

Jenis: LPCTSTR

Penunjuk ke string yang dihentikan null yang berisi nama nilai yang menyimpan string jalur yang tidak terlampir.

[out] pszPath

Jenis: LPTSTR

Buffer untuk menahan jalur yang diperluas. Anda harus mengatur ukuran buffer ini ke MAX_PATH untuk memastikan bahwa ukurannya cukup besar untuk menahan string yang dikembalikan.

dwFlags

Jenis: DWORD

Dicadangkan.

Nilai kembali

Jenis: LSTATUS

Mengembalikan ERROR_SUCCESS jika berhasil, atau kode kesalahan Windows sebaliknya.

Keterangan

Jenis data dari nilai registri yang ditentukan harus REG_EXPAND_SZ atau REG_SZ. Jika memiliki jenis REG_EXPAND_SZ , variabel lingkungan apa pun dalam string registri akan diperluas dengan ExpandEnvironmentStrings. Jika memiliki jenis data REG_SZ , variabel lingkungan tidak akan diperluas dan string yang diacu oleh pszPath akan identik dengan string dalam registri.

String lingkungan berikut akan digantikan oleh jalur yang setara.

String lingkungan	Folder
%USERPROFILE%	Folder profil pengguna saat ini
%ALLUSERSPROFILE%	Folder profil Semua Pengguna
%ProgramFiles%	Folder File Program
%SystemRoot%	Folder akar sistem
%SystemDrive%	Huruf kandar sistem

Catatan %USERPROFILE% relatif terhadap pengguna yang melakukan panggilan. Fungsi ini tidak berfungsi jika pengguna ditiru dari layanan.

Catatan

Header shlwapi.h mendefinisikan SHRegGetPath sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 5.0 atau yang lebih baru)

Bagikan melalui