Функция ResUtilGetExpandSzValue (resapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. Поддержка этого метода была удалена в Windows Server 2003. Эта функция не экспортируется из ResUtils.dll и программы или библиотеки DLL, которые статически связываются с ней, не будут загружаться.]
Возвращает расширяемое строковое значение из базы данных кластера.
Синтаксис
LPWSTR ResUtilGetExpandSzValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[in] BOOL bExpand
);
Параметры
[in] hkeyClusterKey
Ключ, определяющий расположение расширяемого строкового значения в базе данных кластера.
[in] pszValueName
Указатель на строку Юникода, завершающуюся null, которая содержит имя извлекаемого значения.
[in] bExpand
Если значение РАВНО TRUE, функция разворачивает строку перед возвратом. Если значение РАВНО FALSE, строка возвращается в расширяемой форме.
Возвращаемое значение
Если операции выполняются успешно, функция возвращает строку Юникода, завершающуюся нулевым значением, содержащую копию указанного значения.
Если операция завершается сбоем, функция возвращает значение NULL. Дополнительные сведения см. в разделе GetLastError.
Комментарии
После завершения работы с памятью, выделенной для значения, возвращаемого служебной функцией ResUtilGetExpandSzValue , необходимо вызвать функцию LocalFree , чтобы освободить ее.
Требования
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2003 Корпоративная, Windows Server 2003 Datacenter |
| Целевая платформа | Windows |
| Header | resapi.h |
| Библиотека | ResUtils.lib |
| DLL | ResUtils.dll |