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。

規格需求

需求	值
目標平台	Universal
標頭	ks.h (包含 Ks.h)
程式庫	Ks.lib