KsAddObjectCreateItemToObjectHeader, fonction (ks.h)

La fonction KsAddObjectCreateItemToObjectHeader ajoute l’élément de création spécifié à un élément vide dans la liste d’éléments de création précédemment allouée pour cet en-tête d’objet. Un élément vide est indiqué par une fonction de distribution null dans l’entrée. Cette fonction suppose que l’appelant sérialise plusieurs modifications apportées à la liste des éléments de création.

Syntaxe

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

Paramètres

[in] Header

Pointe vers l’en-tête d’objet qui contient la table de création enfant précédemment allouée.

[in] Create

Spécifie la fonction create dispatch à utiliser.

[in] Context

Spécifie le paramètre de contexte.

[in] ObjectClass

Spécifie un pointeur vers une chaîne de caractères terminée par NULL qui est utilisée pour la comparaison sur les demandes de création. Ce pointeur doit rester valide pendant que l’objet est actif.

[in, optional] SecurityDescriptor

Spécifie le descripteur de sécurité. Cela doit rester valide pendant que l’objet est actif.

Valeur de retour

La fonction KsAddObjectCreateItemToObjectHeader retourne STATUS_SUCCESS si un emplacement d’élément de création vide a été trouvé et que l’élément a été ajouté. En cas d’échec, elle retourne STATUS_ALLOTTED_SPACE_EXCEEDED.

Configuration requise

Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib