Функция 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. Дополнительные сведения см. в разделе Безопасность раздела реестра и права доступа.

Этот дескриптор возвращается функцией RegCreateKeyEx или RegOpenKeyEx . Это также может быть один из следующих предопределенных ключей:

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 и сохраняет требуемый размер буфера в переменной, на которую указывает pcbData. В этом случае содержимое буфера не определено.

[in] Flags

Этот параметр может иметь значение 0 или следующее значение.

[in, optional] pszDirectory

Путь к каталогу.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки.

Если буфер pcbData слишком мал для получения строки, функция возвращает ERROR_MORE_DATA.

Версия ANSI этой функции возвращает ERROR_CALL_NOT_IMPLEMENTED.

Комментарии

Функция RegLoadMUIString поддерживается только для Юникода. Хотя объявлены обе версии юникода (W) и ANSI (A) этой функции, функция RegLoadMUIStringA возвращает ERROR_CALL_NOT_IMPLEMENTED. Приложения должны явно вызывать RegLoadMUIStringW или указывать Юникод в качестве набора символов в вызовах платформы (PInvoke).

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0600 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Требования

См. также раздел

Функции реестра