Функция KsUnserializeObjectPropertiesFromRegistry (ks.h)
Функция KsUnserializeObjectPropertiesFromRegistry при указании целевого объекта и пути реестра перечисляет именованные значения и применяет их как сериализованные данные к указанным наборам свойств, перечисленным в сериализованных данных. IRP создается при отправке сериализованных данных, поэтому не предполагается использовать структуры свойств KS для внутреннего определения наборов свойств. Функция не использует имена значений.
Синтаксис
KSDDKAPI NTSTATUS KsUnserializeObjectPropertiesFromRegistry(
[in] PFILE_OBJECT FileObject,
[in, optional] HANDLE ParentKey,
[in, optional] PUNICODE_STRING RegistryPath
);
Параметры
[in] FileObject
Указывает объект файла, свойства которого задаются.
[in, optional] ParentKey
При необходимости содержит дескриптор родительского пути или NULL. Необходимо передать родительский ключ и (или) RegistryPath.
[in, optional] RegistryPath
При необходимости содержит путь к ключу, подразделы которого будут перечисляться как наборы свойств, или в противном случае NULL. Необходимо передать ParentKey или путь реестра.
Возвращаемое значение
Функция KsUnserializeObjectPropertiesFromRegistry возвращает STATUS_SUCCESS, если наборы свойств были несериализированы. Функция возвращает ошибку, если путь к реестру недопустим, один из вложенных ключей был недопустимым, если свойство было неудачным, сериализованный формат был недопустимым, или набор свойств не поддерживается в объекте.
Требования
Требование | Ценность |
---|---|
целевая платформа | Всеобщий |
заголовка | ks.h (include Ks.h) |
библиотеки | Ks.lib |