Baca dalam bahasa Inggris

Bagikan melalui

Fungsi RegLoadMUIStringA (winreg.h)

  • Artikel

Memuat string yang ditentukan dari kunci dan subkuntah yang ditentukan.

Sintaksis

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 berikut yang telah ditentukan sebelumnya:

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:

@[ jalur]\ strID

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

[in] cbOutBuf

Ukuran pszOutBuf buffer, dalam byte.

[out, optional] pcbData

Penunjuk ke variabel yang menerima ukuran data yang disalin ke pszOutBuf buffer, 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 Arti
REG_MUI_STRING_TRUNCATE
0x00000001
 String dipotong agar sesuai dengan ukuran pszOutBuf buffer. Jika bendera ini ditentukan, pcbData harus NULL.

[in, optional] pszDirectory

Jalur direktori.

Mengembalikan nilai

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 akan mengembalikan ERROR_MORE_DATA.

Versi ANSI dari fungsi ini mengembalikan ERROR_CALL_NOT_IMPLEMENTED.

Komentar

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

Lihat juga

Fungsi Registri