Condividi tramite

Funzione KsAddObjectCreateItemToObjectHeader (ks.h)

  • Articolo

La funzione KsAddObjectCreateItemToObjectHeader aggiunge l'elemento create-item specificato a un elemento vuoto nell'elenco di elementi di creazione precedentemente allocati per questa intestazione dell'oggetto. Un elemento vuoto è indicato da un NULL creare una funzione dispatch nella voce. Questa funzione presuppone che il chiamante serializzi più modifiche all'elenco di elementi di creazione.

Sintassi

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

Parametri

[in] Header

Punta all'intestazione dell'oggetto che contiene la tabella figlio allocata in precedenza.

[in] Create

Specifica la funzione create dispatch da usare.

[in] Context

Specifica il parametro di contesto.

[in] ObjectClass

Specifica un puntatore a un NULLstringa di caratteri con terminazione utilizzata per il confronto sulle richieste di creazione. Questo puntatore deve rimanere valido mentre l'oggetto è attivo.

[in, optional] SecurityDescriptor

Specifica il descrittore di sicurezza. Deve rimanere valido mentre l'oggetto è attivo.

Valore restituito

La funzione KsAddObjectCreateItemToObjectHeader restituisce STATUS_SUCCESS se è stato trovato uno slot di elementi di creazione vuoto e l'elemento è stato aggiunto. In caso di esito negativo, restituisce STATUS_ALLOTTED_SPACE_EXCEEDED.

Fabbisogno

Requisito Valore
piattaforma di destinazione Universale
intestazione ks.h (include Ks.h)
libreria Ks.lib