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

指定要使用的 create dispatch 函数。

[in] Context

指定上下文参数。

[in] ObjectClass

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

[in, optional] SecurityDescriptor

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

返回值

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

要求

要求
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib