Função EcSetObjectArrayProperty (evcoll.h)

A função EcSetObjectArrayProperty define um valor de propriedade em uma matriz de valores de propriedade para as fontes de evento de uma assinatura.

Sintaxe

BOOL EcSetObjectArrayProperty(
  [in] EC_OBJECT_ARRAY_PROPERTY_HANDLE ObjectArray,
  [in] EC_SUBSCRIPTION_PROPERTY_ID     PropertyId,
  [in] DWORD                           ArrayIndex,
  [in] DWORD                           Flags,
  [in] PEC_VARIANT                     PropertyValue
);

Parâmetros

[in] ObjectArray

Um identificador para a matriz que contém o valor da propriedade a ser definido. 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] PropertyId

Um identificador que especifica qual propriedade deve ser definida. Especifique um valor da enumeração EC_SUBSCRIPTION_PROPERTY_ID . Defina as propriedades Address, Enabled, UserName e Password na matriz especificando os valores EcSubscriptionEventSourceAddress, EcSubscriptionEventSourceEnabled, EcSubscriptionEventSourceUserName ou EcSubscriptionEventSourcePassword .

[in] ArrayIndex

O índice do objeto na matriz na qual definir um valor de propriedade.

[in] Flags

Reservado. Deve ser 0.

[in] PropertyValue

O valor da propriedade.

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.

Exemplos

Por exemplo, código usando a função EcSetObjectArrayProperty , 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