Función KsAddObjectCreateItemToObjectHeader (ks.h)

La función KsAddObjectCreateItemToObjectHeader agrega el elemento create-item especificado a un elemento vacío en la lista de elementos de creación asignada previamente para este encabezado de objeto. Un elemento vacío se indica mediante una función de distribución create NULL en la entrada. Esta función supone que el autor de la llamada serializa varios cambios en la lista de elementos de creación.

Sintaxis

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

Parámetros

[in] Header

Apunta al encabezado de objeto que contiene la tabla secundaria asignada anteriormente: crear.

[in] Create

Especifica la función create dispatch que se va a usar.

[in] Context

Especifica el parámetro de contexto.

[in] ObjectClass

Especifica un puntero a una cadena de caracteres terminada en NULL que se usa para la comparación en las solicitudes de creación. Este puntero debe permanecer válido mientras el objeto está activo.

[in, optional] SecurityDescriptor

Especifica el descriptor de seguridad. Esto debe permanecer válido mientras el objeto está activo.

Valor devuelto

La función KsAddObjectCreateItemToObjectHeader devuelve STATUS_SUCCESS si se encontró una ranura de elemento de creación vacía y se agregó el elemento. Si no se realiza correctamente, devuelve STATUS_ALLOTTED_SPACE_EXCEEDED.

Requisitos

Plataforma de destino	Universal
Header	ks.h (incluya Ks.h)
Library	Ks.lib