KsAddObjectCreateItemToObjectHeader-Funktion (ks.h)

Die KsAddObjectCreateItemToObjectHeader-Funktion fügt das angegebene create-item einem leeren Element in der zuvor zugeordneten Erstellungselementliste für diesen Objektheader hinzu. Ein leeres Element wird durch eine NULL create dispatch-Funktion im Eintrag gekennzeichnet. Bei dieser Funktion wird davon ausgegangen, dass der Aufrufer mehrere Änderungen an der Liste der Erstellungselemente serialisiert.

Syntax

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

Parameter

[in] Header

Verweist auf den Objektheader, der die zuvor zugeordnete untergeordnete Create-Tabelle enthält.

[in] Create

Gibt die zu verwendende Create Dispatch-Funktion an.

[in] Context

Gibt den Kontextparameter an.

[in] ObjectClass

Gibt einen Zeiger auf eine Zeichenfolge mit NULL-Beendigung an, die für den Vergleich bei Erstellungsanforderungen verwendet wird. Dieser Zeiger muss gültig bleiben, während das Objekt aktiv ist.

[in, optional] SecurityDescriptor

Gibt den Sicherheitsdeskriptor an. Dies muss gültig bleiben, während das Objekt aktiv ist.

Rückgabewert

Die KsAddObjectCreateItemToObjectHeader-Funktion gibt STATUS_SUCCESS zurück, wenn ein leerer Erstellungselementslot gefunden und das Element hinzugefügt wurde. Wenn der Fehler nicht erfolgreich ist, wird STATUS_ALLOTTED_SPACE_EXCEEDED zurückgegeben.

Anforderungen