Função EcInsertObjectArrayElement (evcoll.h)

A função EcInsertObjectArrayElement insere um objeto vazio em uma matriz de valores de propriedade para as fontes de evento de uma assinatura. O objeto é inserido em um índice de matriz especificado.

Sintaxe

BOOL EcInsertObjectArrayElement(
  [in] EC_OBJECT_ARRAY_PROPERTY_HANDLE ObjectArray,
  [in] DWORD                           ArrayIndex
);

Parâmetros

[in] ObjectArray

Um identificador para a matriz na qual o objeto é inserido. A matriz contém valores de propriedade para as fontes de evento de uma assinatura. O identificador de matriz é retornado pelo método EcGetSubscriptionProperty quando o valor EcSubscriptionEventSources é passado para o parâmetro Subscription .

[in] ArrayIndex

Um índice de matriz que indica onde inserir o objeto.

Valor retornado

Essa função retorna BOOL.

Comentários

As matrizes são baseadas em zero, portanto, o índice do primeiro item na matriz é 0.

Use o EcSetObjectArrayProperty para definir propriedades individuais de um objeto vazio inserido na matriz especificada no parâmetro ObjectArray .

Exemplos

Por exemplo, código usando a função EcInsertObjectArrayElement , consulte Adicionando uma fonte de evento a uma assinatura iniciada pelo coletor.

Requisitos

Confira também

Funções do Coletor de Eventos do Windows