Fungsi SHRegGetPathW (shlwapi.h)

Artikel
11/20/2024

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

Sintaksis

LSTATUS SHRegGetPathW(
  [in]  HKEY    hKey,
  [in]  LPCWSTR pcszSubKey,
  [in]  LPCWSTR pcszValue,
  [out] LPWSTR  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

Dipesan.

Mengembalikan nilai

Jenis: LSTATUS

Mengembalikan ERROR_SUCCESS jika berhasil, atau kode kesalahan Windows sebaliknya.

Komentar

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 ditujukkan oleh pszPath akan identik dengan string dalam registri.

String lingkungan berikut akan digantikan oleh jalur yang setara.

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

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

Nota

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

Bagikan melalui