EcSetObjectArrayProperty-Funktion (evcoll.h)

Die EcSetObjectArrayProperty-Funktion legt einen Eigenschaftswert in einem Array von Eigenschaftenwerten für die Ereignisquellen eines Abonnements fest.

Syntax

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
);

Parameter

[in] ObjectArray

Ein Handle für das Array, das den festzulegenden Eigenschaftswert enthält. Das Array enthält Eigenschaftswerte für die Ereignisquellen eines Abonnements. Das Arrayhandle wird von der EcGetSubscriptionProperty-Methode zurückgegeben, wenn der EcSubscriptionEventSources-Wert an den Subscription-Parameter übergeben wird.

[in] PropertyId

Ein Bezeichner, der angibt, welche Eigenschaft festgelegt werden soll. Geben Sie einen Wert aus der EC_SUBSCRIPTION_PROPERTY_ID-Enumeration an. Legen Sie die Eigenschaften Address, Enabled, UserName und Password im Array fest, indem Sie die Werte EcSubscriptionEventSourceAddress, EcSubscriptionEventSourceEnabled, EcSubscriptionEventSourceUserName oder EcSubscriptionEventSourcePassword angeben.

[in] ArrayIndex

Der Index des Objekts im Array, für das ein Eigenschaftswert festgelegt werden soll.

[in] Flags

Reserviert. Muss den Wert 0 (null) haben.

[in] PropertyValue

Der Wert der Eigenschaft.

Rückgabewert

Diese Funktion gibt BOOL zurück.

Hinweise

Arrays sind nullbasiert, sodass der Index für das erste Element im Array 0 ist.

Beispiele

Beispielcode mit der EcSetObjectArrayProperty-Funktion finden Sie unter Hinzufügen einer Ereignisquelle zu einem vom Collector initiierten Abonnement.

Anforderungen

Weitere Informationen

Windows-Ereignissammlerfunktionen