Функция KsUnserializeObjectPropertiesFromRegistry (ks.h)

Статья
02/29/2024

Функция 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 (включая Ks.h)
Библиотека	Ks.lib

Share via