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

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	evcoll.h
Bibliothek	Wecapi.lib
DLL	Wecapi.dll

Weitere Informationen

Windows-Ereignissammlerfunktionen