KsAddObjectCreateItemToObjectHeader, fonction (ks.h)

La fonction KsAddObjectCreateItemToObjectHeader ajoute l’élément create-item 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 dispatch create 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 enfant-create 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 tant que l’objet est actif.

[in, optional] SecurityDescriptor

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

Valeur retournée

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

Configuration requise