Partager via

KsAddObjectCreateItemToObjectHeader, fonction (ks.h)

  • Article

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 un NULL créer une fonction de répartition dans l’entrée. Cette fonction suppose que l’appelant sérialise plusieurs modifications dans 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 null NULL-terminated character 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.

Exigences

Exigence Valeur
plateforme cible Universel
d’en-tête ks.h (include Ks.h)
bibliothèque Ks.lib