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

Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	evcoll.h
Biblioteca	Wecapi.lib
DLL	Wecapi.dll

Confira também

Funções do Coletor de Eventos do Windows