Fungsi RegLoadMUIStringA (winreg.h)

Artikel
08/27/2023

Memuat string yang ditentukan dari kunci dan subkuncar yang ditentukan.

Sintaks

LSTATUS RegLoadMUIStringA(
  [in]            HKEY    hKey,
  [in, optional]  LPCSTR  pszValue,
  [out, optional] LPSTR   pszOutBuf,
  [in]            DWORD   cbOutBuf,
  [out, optional] LPDWORD pcbData,
  [in]            DWORD   Flags,
  [in, optional]  LPCSTR  pszDirectory
);

Parameter

[in] hKey

Handel ke kunci registri terbuka. Kunci harus dibuka dengan hak akses KEY_QUERY_VALUE. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.

Handel ini dikembalikan oleh fungsi RegCreateKeyEx atau RegOpenKeyEx . Ini juga bisa menjadi salah satu kunci yang telah ditentukan sebelumnya berikut:

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] pszValue

Nama nilai registri.

[out, optional] pszOutBuf

Penunjuk ke buffer yang menerima string.

String formulir berikut menerima penanganan khusus:

@[path]\dllname,-strID

String dengan strID pengidentifikasi dimuat dari nama dll; jalur bersifat opsional. Jika parameter pszDirectory bukan NULL, direktori ditambahkan ke jalur yang ditentukan dalam data registri. Perhatikan bahwa nama dll dapat berisi variabel lingkungan yang akan diperluas.

[in] cbOutBuf

Ukuran buffer pszOutBuf , dalam byte.

[out, optional] pcbData

Penunjuk ke variabel yang menerima ukuran data yang disalin ke buffer pszOutBuf , dalam byte.

Jika buffer tidak cukup besar untuk menyimpan data, fungsi mengembalikan ERROR_MORE_DATA dan menyimpan ukuran buffer yang diperlukan dalam variabel yang ditunjukkan oleh pcbData. Dalam hal ini, konten buffer tidak terdefinisi.

[in] Flags

Parameter ini bisa 0 atau nilai berikut.

Nilai	Makna
REG_MUI_STRING_TRUNCATE 0x00000001	String dipotok agar sesuai dengan ukuran buffer pszOutBuf yang tersedia. Jika bendera ini ditentukan, pcbData harus NULL.

[in, optional] pszDirectory

Jalur direktori.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem.

Jika buffer pcbData terlalu kecil untuk menerima string, fungsi mengembalikan ERROR_MORE_DATA.

Versi ANSI dari fungsi ini mengembalikan ERROR_CALL_NOT_IMPLEMENTED.

Keterangan

Fungsi RegLoadMUIString hanya didukung untuk Unicode. Meskipun versi Unicode (W) dan ANSI (A) dari fungsi ini dideklarasikan, fungsi RegLoadMUIStringA mengembalikan ERROR_CALL_NOT_IMPLEMENTED. Aplikasi harus secara eksplisit memanggil RegLoadMUIStringW atau menentukan Unicode sebagai karakter yang diatur dalam panggilan pemanggilan platform (PInvoke).

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Catatan

Header winreg.h mendefinisikan RegLoadMUIString 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 Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	winreg.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

Fungsi Registri

Share via