Funzione KsAddObjectCreateItemToObjectHeader (ks.h)

La funzione KsAddObjectCreateItemToObjectHeader aggiunge l'elemento di creazione specificato a un elemento vuoto nell'elenco di elementi creati precedentemente allocati per questa intestazione dell'oggetto. Un elemento vuoto è indicato da una funzione dispatch create NULL 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 di creazione 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 una stringa di caratteri con terminazione NULL 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. Se ha esito negativo, restituisce STATUS_ALLOTTED_SPACE_EXCEEDED.

Requisiti