Поделиться через


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

Функция KsAddObjectCreateItemToObjectHeader добавляет указанный элемент create-item в пустой элемент в ранее выделенном списке элементов создания для этого заголовка объекта. Пустой элемент обозначается функцией диспетчеризации создания NULL в записи. Эта функция предполагает, что вызывающий объект сериализует несколько изменений в списке элементов создания.

Синтаксис

KSDDKAPI NTSTATUS KsAddObjectCreateItemToObjectHeader(
  [in]           KSOBJECT_HEADER      Header,
  [in]           PDRIVER_DISPATCH     Create,
  [in]           PVOID                Context,
  [in]           PWSTR                ObjectClass,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Параметры

[in] Header

Указывает на заголовок объекта, содержащий ранее выделенную таблицу дочернего создания.

[in] Create

Указывает используемую функцию создания диспетчеризации.

[in] Context

Задает параметр контекста.

[in] ObjectClass

Указывает указатель на строку символов, завершающуюся null, которая используется для сравнения при запросах на создание. Этот указатель должен оставаться действительным, пока объект активен.

[in, optional] SecurityDescriptor

Указывает дескриптор безопасности. Это значение должно оставаться действительным, пока объект активен.

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

Функция KsAddObjectCreateItemToObjectHeader возвращает STATUS_SUCCESS, если был найден пустой слот создания элемента и элемент был добавлен. В случае неудачи он возвращает STATUS_ALLOTTED_SPACE_EXCEEDED.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
Библиотека Ks.lib