KsAddObjectCreateItemToObjectHeader 函数 （ks.h）

KsAddObjectCreateItemToObjectHeader 函数将指定的创建项添加到以前为此对象标头分配的创建项列表中的空项。 空项由 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

指定要使用的 create dispatch 函数。

[in] Context

指定上下文参数。

[in] ObjectClass

指定指向 NULL终止的字符串的指针，该字符串用于对创建请求进行比较。 此指针在对象处于活动状态时必须保持有效。

[in, optional] SecurityDescriptor

指定安全描述符。 当对象处于活动状态时，这必须保持有效。

返回值

KsAddObjectCreateItemToObjectHeader 函数返回STATUS_SUCCESS如果找到空的创建项槽并添加了该项。 如果失败，它将返回STATUS_ALLOTTED_SPACE_EXCEEDED。

要求