共用方式為


RegLoadMUIStringA 函式 (winreg.h)

從指定的索引鍵和子機碼載入指定的字串。

語法

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
);

參數

[in] hKey

開啟登錄機碼的句柄。 金鑰必須使用KEY_QUERY_VALUE訪問許可權開啟。 如需詳細資訊,請參閱 登入機碼安全性和存取權限

此句柄是由 RegCreateKeyExRegOpenKeyEx 函式所傳回。 它也可以是下列其中一個 預先定義的索引鍵

HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS

[in, optional] pszValue

登錄值的名稱。

[out, optional] pszOutBuf

接收字串之緩衝區的指標。

下列表單的字串會收到特殊處理:

@[path]\dllname,-strID

標識子 strID 的字串會從 dllname載入;路徑 是選擇性的。 如果 pszDirectory 參數未 NULL,則會在登錄數據中指定的路徑前面加上目錄。 請注意,dllname 可以包含要展開的環境變數。

[in] cbOutBuf

pszOutBuf 緩衝區的大小,以位元組為單位。

[out, optional] pcbData

變數的指標,接收複製到 pszOutBuf 緩衝區的數據大小,以位元組為單位。

如果緩衝區不夠大而無法保存數據,函式會傳回ERROR_MORE_DATA,並將所需的緩衝區大小儲存在 所指向的變數中。 在此情況下,緩衝區的內容是未定義的。

[in] Flags

此參數可以是 0 或下列值。

價值 意義
REG_MUI_STRING_TRUNCATE
0x00000001
字串會截斷,以符合 pszOutBuf 緩衝區 可用大小。 如果指定此旗標, 必須 NULL

[in, optional] pszDirectory

目錄路徑。

傳回值

如果函式成功,則傳回值會ERROR_SUCCESS。

如果函式失敗,傳回值是 系統錯誤碼

如果 緩衝區太小而無法接收字串,函式會傳回ERROR_MORE_DATA。

此函式的 ANSI 版本會傳回ERROR_CALL_NOT_IMPLEMENTED。

言論

RegLoadMUIString 函式僅支援 Unicode。 雖然已宣告此函式的 Unicode (W) 和 ANSI (A) 版本,但 RegLoadMUIStringA 函式會傳回ERROR_CALL_NOT_IMPLEMENTED。 應用程式應該明確地呼叫 RegLoadMUIStringW,或指定 Unicode 作為平台調用 (PInvoke) 呼叫中的字元集。

若要編譯使用此函式的應用程式,請將_WIN32_WINNT定義為0x0600或更新版本。 如需詳細資訊,請參閱使用 Windows 標頭

注意

winreg.h 標頭會根據 UNICODE 預處理器常數的定義,將 RegLoadMUIString 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winreg.h (包括 Windows.h)
連結庫 Advapi32.lib
DLL Advapi32.dll

另請參閱

登錄函式